You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
koffice/krita/sdk/kis_annotation.h

90 lines
2.8 KiB

/*
* This file is part of the KDE project
*
* Copyright (c) 2005 Boudewijn Rempt <boud@valdyas.org>
*
* 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 2 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, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef _KIS_ANNOTATION_H_
#define _KIS_ANNOTATION_H_
#include <ksharedptr.h>
#include "kis_shared_ptr_vector.h"
#include <qstring.h>
#include <qcstring.h>
#include <qmemarray.h>
/**
* An data extension mechanism for Krita.
*
* An annotation can be of something like a QByteArray or a QString op a more specific
* datatype that can be attached to an image (or maybe later, if needed, to a layer)
* and contains data that must be associated with an image for purposes of import/export.
*
* Annotations will be saved to krita images and may be exported in filetypes that support
* them.
*
* Examples of annotations are EXIF data and ICC profiles.
*/
class KisAnnotation : public KShared {
public:
/**
* Creates a new annotation object. The annotation object cannot be changed later
*
* @param type a non-localized string identifying the type of the annotation
* @param description a localized string describing the annotation
* @param data a binary blob containing the annotation data
*/
KisAnnotation(const QString & type, const QString & description, const QByteArray & data)
: m_type(type),
m_description(description),
m_annotation(data) {};
/**
* @return a non-localized string identifiying the type of the annotation
*/
QString & type() {return m_type;};
/**
* @return a localized string describing the type of the annotations
* for user interface purposes.
*/
QString & description() {return m_description;};
/**
* @return a binary blob representation of this annotation
*/
QByteArray & annotation() { return m_annotation;};
private:
QString m_type;
QString m_description;
QByteArray m_annotation;
};
typedef KSharedPtr<KisAnnotation> KisAnnotationSP;
typedef KisSharedPtrVector<KisAnnotation> vKisAnnotationSP;
typedef vKisAnnotationSP::iterator vKisAnnotationSP_it;
typedef vKisAnnotationSP::const_iterator vKisAnnotationSP_cit;
#endif // _KIS_ANNOTATION_H_