- void addClip(QDomElement elem, QString clipId, bool createClipItem = true);
- void addClipInfo(QDomElement elem, QDomElement orig, QString clipId);
- void addFolder(const QString foldername, const QString &clipId, bool edit);
- void deleteFolder(const QString foldername, const QString &clipId);
- void slotAddClipFile(const KUrl url, const QString group, const QString &groupId = QString());
- void slotAddClipList(const KUrl::List urls, const QString group, const QString &groupId = QString());
- void slotAddFolder(const QString folderName);
- void slotDeleteFolder(const QString folderName, const QString &id);
- void slotEditFolder(const QString folderName, const QString oldfolderName, const QString &clipId);
- void slotAddColorClipFile(const QString name, const QString color, QString duration, const QString group, const QString &groupId = QString());
- void slotAddSlideshowClipFile(const QString name, const QString path, int count, const QString duration, const bool loop, const bool fade, const QString &luma_duration, const QString &luma_file, const int softness, const QString group, const QString &groupId = QString());
+
+ /** @brief Adds a clip to the project tree.
+ * @return false if the user aborted the operation, true otherwise */
+ bool addClip(QDomElement elem, QString clipId, bool createClipItem = true);
+
+ /** @brief Updates information about a clip.
+ * @param elem the <kdenlive_producer />
+ * @param orig the potential <producer />
+ * @param clipId the producer id
+ * @return false if the user aborted the operation (in case the clip wasn't
+ * there yet), true otherwise
+ *
+ * If the clip wasn't added before, it tries to add it to the project. */
+ bool addClipInfo(QDomElement elem, QDomElement orig, QString clipId);
+ void slotAddClipFile(const KUrl &url, const QString &group, const QString &groupId = QString());
+ void slotAddClipList(const KUrl::List urls, const QString &group, const QString &groupId = QString());