Differential D14815 Diff 39702 libs/ui/KisPaletteEditor.h

Changeset View

Standalone View

libs/ui/KisPaletteEditor.h

This file was added.

		1		/*
		2		* Copyright (c) 2018 Michael Zhou <simeirxh@gmail.com>
		3		*
		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.
		8		*
		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.
		13		*
		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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
		17		*/
		18
		19		#ifndef KISPALETTEMANAGER_H
		20		#define KISPALETTEMANAGER_H
		21
		22		#include <QObject>
		23		#include <QScopedPointer>
		24		#include <KisSwatch.h>
		25
		26		#include <kritaui_export.h>
		27
		28		class KoColorSet;
		29		class KisPaletteModel;
		30		class KisViewManager;
		31		class KisSwatchGroup;
		32		class KisViewManager;
		33
		34		/**
		35		* @brief The PaletteEditor class
		36		* this class manipulates a KisPaletteModel using GUI elements and communicate
		37		* with KisDocument
		38		*
		39		* Changes made in this class won't be done to the palette if the palette is
		40		* read only (not editable, isEditable() == false)
		41		*/
		42		class KRITAUI_EXPORT KisPaletteEditor : public QObject
		43		{
		44		Q_OBJECT
		45		public:
		46		struct PaletteInfo;
		47
		48		public:
		49		explicit KisPaletteEditor(QObject *parent = Q_NULLPTR);
		50		~KisPaletteEditor();
		51
		52		void setPaletteModel(KisPaletteModel *model);
		53		void setView(KisViewManager *view);
		54
		55		void addPalette();
		56		void importPalette();
		57		void removePalette(KoColorSet *);
		58
		59		/**
		60		* @brief rowNumberOfGroup
		61		* @param oriName the original name of a group at the creation of the instance
		62		* @return newest row number of the group
		63		*/
		64		int rowNumberOfGroup(const QString &oriName) const;
		65		/**
		66		* @brief oldNameFromNewName
		67		* @param newName the current name of a group
		68		* @return the name of the group at the creation of the instance
		69		*/
		70		QString oldNameFromNewName(const QString &newName) const;
		71		/**
		72		* @brief duplicateExistsFilename
		73		* @param name
		74		* @return true if the a palette in the resource system that has filename
		75		* name already exists else false
		76		*/
		77		bool duplicateExistsFilename(const QString &filename) const;
		78		QString relativePathFromSaveLocation() const;
		79
		80		void rename(const QString &newName);
		81		void changeFilename(const QString &newName);
		82		void changeColCount(int);
		83
		84		/**
		85		* @brief addGroup
		86		* @param name original group name
		87		* @param rowNumber
		88		* @return new group's name if change accpeted, empty string if cancelled
		89		*/
		90		QString addGroup();
		91		/**
		92		* @brief removeGroup
		93		* @param name original group name
		94		* @return true if change accepted, false if cancelled
		95		*/
		96		bool removeGroup(const QString &name);
		97		/**
		98		* @brief renameGroup
		99		* @param oldName
		100		* @return new name if change accpeted, empty string if cancelled
		101		*/
		102		QString renameGroup(const QString &oldName);
		103		void changeGroupRowCount(const QString &name, int newRowCount);
		104		void setGlobal(bool);
		105		void setReadOnly(bool);
		106
		107		void setEntry(const KoColor &color, const QModelIndex &index);
		108		void removeEntry(const QModelIndex &index);
		109		void modifyEntry(const QModelIndex &index);
		110		void addEntry(const KoColor &color);
		111
		112		bool isModified() const;
		113
		114		/**
		115		* @brief getModifiedGroup
		116		* @param originalName name of the group at the creation of the instance
		117		* @return the modified group
		118		*/
		119		const KisSwatchGroup &getModifiedGroup(const QString &originalName) const;
		120
		121		/**
		122		* @brief updatePalette
		123		* MUST be called to make the changes into the resource server
		124		*/
		125		void updatePalette();
		126
		127		private Q_SLOTS:
		128		void slotGroupNameChanged(const QString &newName);
		129		void slotPaletteChanged();
		130		void slotPolluteDoc();
		131
		132		private:
		133		QString newPaletteFileName(bool isGlobal);
		134		QString newGroupName() const;
		135		void setNonGlobal();
		136		void setGlobal();
		137		bool duplicateExistsGroupName(const QString &name) const;
		138		bool duplicateExistsOriginalGroupName(const QString &name) const;
		139		void uploadPaletteList() const;
		140		QString filenameFromPath(const QString &path) const;
		141
		142		private:
		143		struct Private;
		144		QScopedPointer<Private> m_d;
		145		};
		146
		147		#endif // KISPALETTEMANAGER_H