- void addClip(const QDomElement &elem, const int clipId);
- void addFolder(const QString foldername, int clipId, bool edit);
- void deleteFolder(const QString foldername, int clipId);
- void slotAddClipFile(const KUrl url, const QString group, const int groupId = -1);
- void slotAddTextClipFile(const QString path, const QString group, const int groupId = -1);
- void editTextClip(QString path, int id);
- void slotAddFolder(const QString folderName);
- void slotDeleteFolder(const QString folderName, const int id);
- void slotEditFolder(const QString folderName, const QString oldfolderName, int clipId);
- void slotAddColorClipFile(const QString name, const QString color, QString duration, const QString group, const int groupId = -1);
- void slotAddSlideshowClipFile(const QString name, const QString path, int count, const QString duration, bool loop, const QString group, const int groupId = -1);
- void deleteClip(const uint clipId);
- int getFramePos(QString duration);
- DocClipBase *getBaseClip(int clipId);
- void updateClip(int id);
- void deleteProjectClip(QList <int> ids);
- void deleteProjectFolder(QMap <QString, int> map);
- /** Inform application of the audio thumbnails generation progress */
- void setThumbsProgress(KUrl url, int progress);
- QString profilePath() const;
- QString description() const;
- /** Returns the document format: PAL or NTSC */
- QString getDocumentStandard();
- void setUrl(KUrl url);
- QDomElement documentInfoXml();
- void setProfilePath(QString path);
- /** Set to true if document needs saving, false otherwise */
- void setModified(bool mod);
- int getFreeClipId();
- /** does the document need saving */
+
+ /** @brief Adds a clip to the project tree.
+ * @return false if the user aborted the operation, true otherwise */
+ bool addClip(QDomElement elem, const 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, const QString &clipId);
+ void slotAddClipList(const KUrl::List &urls, const stringMap &data = stringMap());
+ void deleteClip(const QString &clipId);
+ int getFramePos(const QString &duration);
+ DocClipBase *getBaseClip(const QString &clipId);
+ void updateClip(const QString &id);
+
+ /** @brief Informs Kdenlive of the audio thumbnails generation progress. */
+ void setThumbsProgress(const QString &message, int progress);
+ const QString &profilePath() const;
+ MltVideoProfile mltProfile() const;
+ const QString description() const;
+ void setUrl(const KUrl &url);
+
+ /** @brief Updates the project profile.
+ * @return true if frame rate was changed */
+ bool setProfilePath(QString path);
+ const QString getFreeClipId();
+
+ /** @brief Defines whether the document needs to be saved. */