/*** Olive - Non-Linear Video Editor Copyright (C) 2020 Olive Team This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ***/ #ifndef NODEINPUT_H #define NODEINPUT_H #include "common/timerange.h" #include "keyframe.h" #include "node/connectable.h" #include "node/inputimmediate.h" #include "node/value.h" #include "splitvalue.h" #include "undo/undocommand.h" namespace olive { class Node; /** * @brief A node parameter designed to take either user input or data from another node */ class NodeInput : public NodeConnectable { Q_OBJECT public: /** * @brief NodeInput Constructor * * @param id * * Unique ID associated with this parameter for this Node. This ID only has to be unique within this Node. Used for * saving/loading data from this Node so that parameter order can be changed without issues loading data saved by an * older version. This of course assumes that parameters don't change their ID. */ NodeInput(Node* parent, const QString &id, NodeValue::Type type, const SplitValue& default_value); NodeInput(Node* parent, const QString &id, NodeValue::Type type, const QVariant& default_value); NodeInput(Node* parent, const QString &id, NodeValue::Type type); virtual ~NodeInput() override; const QString& id() const { return id_; } QString name() const; void set_name(const QString& name) { name_ = name; emit NameChanged(name_); } bool IsArray() const { return is_array_; } void SetIsArray(bool e) { is_array_ = e; } void DisconnectAll(); void Load(QXmlStreamReader* reader, XMLNodeData& xml_node_data, const QAtomicInt* cancelled); void Save(QXmlStreamWriter* writer) const; /** * @brief Deliberately shadow QObject parent, since we only expect NodeInput to have Node as a parent */ Node* parent() const; /** * @brief The data type this parameter outputs * * This can be used in conjunction with NodeInput::can_accept_type() to determine whether this parameter can be * connected to it. */ NodeValue::Type GetDataType() const { return data_type_; } void SetDataType(NodeValue::Type type) { data_type_ = type; emit DataTypeChanged(type); } const std::map& edges() const { return input_connections(); } bool IsConnected(int element = -1) const { return input_connections().find(element) != input_connections().end(); } /** * @brief Returns TRUE if the value is expected to always be the same (i.e. no keyframes and * not connected to anything) */ bool IsStatic(int element = -1) const { return !IsConnected(element) && !GetImmediate(element)->is_keyframing(); } Node* GetConnectedNode(int element = -1) const { return input_connections().at(element); } bool IsConnectable() const { return connectable_; } void SetConnectable(bool e) { connectable_ = e; } const QVector &GetKeyframeTracks(int element = -1) const { return GetImmediate(element)->keyframe_tracks(); } NodeKeyframe* GetKeyframeAtTimeOnTrack(const rational& time, int track, int element) const { return GetImmediate(element)->get_keyframe_at_time_on_track(time, track); } NodeKeyframe::Type GetBestKeyframeTypeForTime(const rational& time, int track, int element) const { return GetImmediate(element)->get_best_keyframe_type_for_time(time, track); } /** * @brief Return whether this input can be keyframed or not */ bool IsKeyframable() const; bool IsKeyframing(int element = -1) const { return GetImmediate(element)->is_keyframing(); } /** * @brief Get non-keyframed value */ QVariant GetStandardValue(int element = -1) const { return NodeValue::combine_track_values_into_normal_value(data_type_, GetSplitStandardValue(element)); } /** * @brief Get non-keyframed value split into components (the way it's stored) */ const SplitValue& GetSplitStandardValue(int element = -1) const { return GetImmediate(element)->get_split_standard_value(); } QVariant GetStandardValueOnTrack(int track, int element = -1) const { return GetImmediate(element)->get_split_standard_value().at(track); } /** * @brief Set non-keyframed value * * This is the value used if keyframing is not enabled. If keyframing is enabled, it is * overwritten. */ void SetStandardValue(const QVariant& value, int element = -1) { SetSplitStandardValue(NodeValue::split_normal_value_into_track_values(data_type_, value), element); } void SetSplitStandardValue(const SplitValue& value, int element = -1) { GetImmediate(element)->set_split_standard_value(value); for (int i=0; iset_standard_value_on_track(value, track); if (IsUsingStandardValue(track, element)) { // If this standard value is being used, we need to send a value changed signal emit ValueChanged(TimeRange(RATIONAL_MIN, RATIONAL_MAX), element); } } /** * @brief Set whether this input can be keyframed or not */ void SetKeyframable(bool k); /** * @brief Copy all values including keyframe information and connections from another NodeInput */ static void CopyValues(NodeInput* source, NodeInput* dest, bool include_connections = true, bool traverse_arrays = true); static void CopyValuesOfElement(NodeInput* source, NodeInput* dst, int src_element, int dst_element); static void CopyValuesOfElement(NodeInput* source, NodeInput* dst, int element) { CopyValuesOfElement(source, dst, element, element); } QStringList get_combobox_strings() const; void set_combobox_strings(const QStringList& strings); void GetDependencies(QVector &list, bool traverse, bool exclusive_only) const; QVariant GetDefaultValue() const { return NodeValue::combine_track_values_into_normal_value(data_type_, default_value_); } const SplitValue& GetSplitDefaultValue() const { return default_value_; } QVariant GetDefaultValueForTrack(int track) const; QVector GetDependencies(bool traverse = true, bool exclusive_only = false) const; QVector GetExclusiveDependencies() const; QVector GetImmediateDependencies() const; NodeKeyframe* GetEarliestKeyframe(int element = -1) { return GetImmediate(element)->get_earliest_keyframe(); } NodeKeyframe* GetLatestKeyframe(int element = -1) { return GetImmediate(element)->get_latest_keyframe(); } bool HasKeyframeAtTime(const rational& time, int element = -1) { return GetImmediate(element)->has_keyframe_at_time(time); } QVector GetKeyframesAtTime(const rational& time, int element = -1) { return GetImmediate(element)->get_keyframe_at_time(time); } void SetIsKeyframing(bool keyframing, int element) { if (IsKeyframable()) { qDebug() << "Ignored set keyframing because this input is not keyframable"; return; } GetImmediate(element)->set_is_keyframing(keyframing); emit KeyframeEnableChanged(keyframing, element); } /// Alias for ArrayResize(ArraySize() + 1) void ArrayAppend(bool undoable = false); void ArrayInsert(int index, bool undoable = false); void ArrayRemove(int index, bool undoable = false); /// Alias for ArrayInsert(0) void ArrayPrepend(bool undoable = false); void ArrayResize(int size, bool undoable = false); /// Alias for ArrayResize(ArraySize() - 1) void ArrayRemoveLast(bool undoable = false); int ArraySize() const { return array_size_; } int GetNumberOfKeyframeTracks() const { return NodeValue::get_number_of_keyframe_tracks(data_type_); } /** * @brief Calculate what the stored value should be at a certain time * * If this is a multi-track data type (e.g. kVec2), this will automatically combine the result into a QVector2D. */ QVariant GetValueAtTime(const rational& time, int element = -1) const; SplitValue GetSplitValuesAtTime(const rational& time, int element = -1) const; /** * @brief Calculate the stored value for a specific track * * For most data types, there is only one track (e.g. `track == 0`), but multi-track data types like kVec2 will * produce the X value on track 0 and the Y value on track 1. */ QVariant GetValueAtTimeForTrack(const rational& time, int track, int element = -1) const; NodeKeyframe* GetClosestKeyframeBeforeTime(const rational& time, int element = -1) const { return GetImmediate(element)->get_closest_keyframe_before_time(time); } NodeKeyframe* GetClosestKeyframeAfterTime(const rational& time, int element = -1) const { return GetImmediate(element)->get_closest_keyframe_after_time(time); } struct KeyframeTrackReference { NodeInput* input; int element; int track; bool operator==(const KeyframeTrackReference& rhs) const { return input == rhs.input && element == rhs.element && track == rhs.track; } }; signals: void NameChanged(const QString& name); void ValueChanged(const olive::TimeRange& range, int element); void KeyframeAdded(NodeKeyframe* key); void KeyframeRemoved(NodeKeyframe* key); void KeyframeTimeChanged(); void PropertyChanged(const QString& s, const QVariant& v); void ArraySizeChanged(int size); void KeyframeEnableChanged(bool enabled, int element); void DataTypeChanged(NodeValue::Type type); void InputConnected(Node* source, int element); void InputDisconnected(Node* source, int element); protected: virtual bool event(QEvent* e) override; virtual void childEvent(QChildEvent* e) override; private: class ArrayInsertCommand : public UndoCommand { public: ArrayInsertCommand(NodeInput* input, int index) : input_(input), index_(index) { } virtual Project* GetRelevantProject() const override; virtual void redo() override { input_->ArrayInsert(index_, false); } virtual void undo() override { input_->ArrayRemove(index_, false); } private: NodeInput* input_; int index_; }; class ArrayRemoveCommand : public UndoCommand { public: ArrayRemoveCommand(NodeInput* input, int index) : input_(input), index_(index) { } virtual Project* GetRelevantProject() const override; protected: virtual void redo() override { // Save immediate data if (input_->IsKeyframable()) { is_keyframing_ = input_->IsKeyframing(index_); } standard_value_ = input_->GetSplitStandardValue(index_); keyframes_ = input_->GetImmediate(index_)->keyframe_tracks(); input_->GetImmediate(index_)->delete_all_keyframes(&memory_manager_); input_->ArrayRemove(index_, false); } virtual void undo() override { input_->ArrayInsert(index_, false); // Restore keyframes foreach (const NodeKeyframeTrack& track, keyframes_) { foreach (NodeKeyframe* key, track) { key->setParent(input_); } } input_->SetSplitStandardValue(standard_value_, index_); if (input_->IsKeyframable()) { input_->SetIsKeyframing(is_keyframing_, index_); } } private: NodeInput* input_; int index_; SplitValue standard_value_; bool is_keyframing_; QVector keyframes_; QObject memory_manager_; }; class ArrayResizeCommand : public UndoCommand { public: ArrayResizeCommand(NodeInput* input, int size) : input_(input), size_(size) {} virtual void redo() override { old_size_ = input_->array_size_; if (old_size_ > size_) { // Decreasing in size, disconnect any extraneous edges for (int i=size_; iedges().at(i); removed_connections_.insert(i, output); DisconnectEdge(output, input_, i); } catch (std::out_of_range&) {} } } input_->ArrayResizeInternal(size_); } virtual void undo() override { for (auto it=removed_connections_.cbegin(); it!=removed_connections_.cend(); it++) { ConnectEdge(it.value(), input_, it.key()); } removed_connections_.clear(); input_->ArrayResizeInternal(old_size_); } virtual Project* GetRelevantProject() const override; private: NodeInput* input_; int size_; int old_size_; QHash removed_connections_; }; void ClearElement(int index); void Init(Node *parent, const QString& id, NodeValue::Type type, const SplitValue &default_val); void LoadImmediate(QXmlStreamReader *reader, int element, XMLNodeData& xml_node_data, const QAtomicInt* cancelled); void SaveImmediate(QXmlStreamWriter *writer, int element) const; void ArrayResizeInternal(int size); NodeInputImmediate* CreateImmediate(); const NodeInputImmediate* GetImmediate(int element = -1) const { return element > -1 ? subinputs_.at(element) : primary_; } NodeInputImmediate* GetImmediate(int element = -1) { return element > -1 ? subinputs_[element] : primary_; } const NodeKeyframeTrack& GetTrackFromKeyframe(NodeKeyframe* key) const { return GetImmediate(key->element())->keyframe_tracks().at(key->track()); } bool IsUsingStandardValue(int track = 0, int element = -1) const { return GetImmediate(element)->is_using_standard_value(track); } QString ValueToString(const QVariant& value) const; QVariant StringToValue(const QString &string, QList &footage_connections, int element); /** * @brief Intelligently determine how what time range is affected by a keyframe */ TimeRange get_range_affected_by_keyframe(NodeKeyframe *key) const; /** * @brief Gets a time range between the previous and next keyframes of index */ TimeRange get_range_around_index(int index, int track, int element) const; NodeInputImmediate* primary_; QVector subinputs_; SplitValue default_value_; /** * @brief Unique identifier of this input within this node */ QString id_; /** * @brief User displayable name of input */ QString name_; /** * @brief Internal keyframable value */ bool keyframable_; bool connectable_; bool is_array_; int array_size_; /** * @brief Default data type */ NodeValue::Type data_type_; private slots: /** * @brief Slot when a keyframe's time changes to keep the keyframes correctly sorted by time */ void InvalidateFromKeyframeTimeChange(); /** * @brief Slot when a keyframe's value changes to signal that the cache needs updating */ void InvalidateFromKeyframeValueChange(); /** * @brief Slot when a keyframe's type changes to signal that the cache needs updating */ void InvalidateFromKeyframeTypeChanged(); /** * @brief Slot when a keyframe's bezier in value changes to signal that the cache needs updating */ void InvalidateFromKeyframeBezierInChange(); /** * @brief Slot when a keyframe's bezier out value changes to signal that the cache needs updating */ void InvalidateFromKeyframeBezierOutChange(); }; uint qHash(const NodeInput::KeyframeTrackReference& ref, uint seed = 0); } #endif // NODEINPUT_H