KoPicture.h

/* This file is part of the KDE project
   Copyright (c) 2001 Simon Hausmann <hausmann@kde.org>
   Copyright (C) 2002, 2003, 2004 Nicolas GOUTTE <goutte@kde.org>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.
 
   This library 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
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
*/
#ifndef __koPicture_h__
#define __koPicture_h__
 
#include <tqstring.h>
#include <tqiodevice.h>
#include <tqpixmap.h>
#include <koffice_export.h>
 
#include "KoPictureKey.h"
 
class KoXmlWriter;
class TQPainter;
class TQSize;
class TQDragObject;
class KURL;
 
class KoPictureShared;

class KOFFICECORE_EXPORT KoPicture
{
public:
    KoPicture(void);

    ~KoPicture(void);

    KoPicture(const KoPicture &other);

    KoPicture& operator=(const KoPicture& other);
 
    KoPictureType::Type getType(void) const;

    KoPictureKey getKey(void) const;

    void setKey(const KoPictureKey& key);

    bool isNull(void) const;

    void draw(TQPainter& painter, int x, int y, int width, int height, int sx = 0, int sy = 0,
              int sw = -1, int sh = -1, bool fastMode = false);

    TQDragObject* dragObject( TQWidget *dragSource = 0L, const char *name = 0L );
 
    bool load(TQIODevice* io, const TQString& extension);

    bool save(TQIODevice* io) const;

    bool saveAsBase64( KoXmlWriter& writer ) const;

    TQString getExtension(void) const;

    TQString getMimeType(void) const;

    TQSize getOriginalSize(void) const;

    void clearAndSetMode(const TQString& newMode);

    void clear(void);

    bool loadFromFile(const TQString& fileName);

    bool loadFromBase64(const TQCString& str);

    bool loadXpm(TQIODevice* io);

    TQPixmap generatePixmap(const TQSize& size, bool smoothScale = false);

    bool setKeyAndDownloadPicture(const KURL& url, TQWidget *window);

    TQImage generateImage(const TQSize& size);

    bool hasAlphaBuffer() const;

    void setAlphaBuffer(bool enable);

    TQImage createAlphaMask(int conversion_flags = 0) const;

    void clearCache(void);
 
    TQString uniquePictureId() const;
    void assignPictureId( uint _id);
 
protected:
    void unlinkSharedData(void);
    void linkSharedData(void) const;
    void createSharedData(void);
    TQString uniqueName() const;
 
protected:
    KoPictureKey m_key;
    KoPictureShared* m_sharedData;
    static uint uniqueValue;
 
    TQString m_uniqueName;
};
 
#endif /* __koPicture_h__ */