tdegraphics/kooka/kocrbase.h

/***************************************************************************
                  kocrbase.h  - base dialog for OCR
                             -------------------
    begin                : Sun Jun 11 2000
    copyright            : (C) 2000 by Klaas Freitag
    email                : freitag@suse.de
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *  This file may be distributed and/or modified under the terms of the    *
 *  GNU General Public License version 2 as published by the Free Software *
 *  Foundation and appearing in the file COPYING included in the           *
 *  packaging of this file.                                                *
 *
 *  As a special exception, permission is given to link this program       *
 *  with any version of the KADMOS ocr/icr engine of reRecognition GmbH,   *
 *  Kreuzlingen and distribute the resulting executable without            *
 *  including the source code for KADMOS in the source distribution.       *
 *
 *  As a special exception, permission is given to link this program       *
 *  with any edition of Qt, and distribute the resulting executable,       *
 *  without including the source code for Qt in the source distribution.   *
 *                                                                         *
 ***************************************************************************/

#ifndef KOCRBASE_H
#define KOCRBASE_H

#include <kdialogbase.h>
#include <kio/previewjob.h>
#include <qimage.h>
#include <qstring.h>

#include <kscanslider.h>
#include <kanimwidget.h>
#include <ksconfig.h>

#include "ksaneocr.h"
/**
  *@author Klaas Freitag
  */


class KookaImage;
class QHBox;
class QVBox;
class QLabel;
class QSize;
class KSpellConfig;
class QCheckBox;
class QGroupBox;

class KOCRBase: public KDialogBase
{
    Q_OBJECT
public:
    KOCRBase( QWidget *, KSpellConfig *spellConfig,
              KDialogBase::DialogType face = KDialogBase::Plain );
    ~KOCRBase();

    virtual EngineError setupGui();

    /**
     * @return the name of the ocr engine
     */
    virtual QString ocrEngineName() const { return QString(); }

    /**
     * @return the filename (without path) of the logo of the ocr engine.
     * the logo needs to be installed in $KDEDIR/share/apps/kooka/pics
     */
    virtual QString ocrEngineLogo() const { return QString(); }

    /**
     * @return a description string of the ocr engine
     */
    virtual QString ocrEngineDesc() const { return QString(); }

    QVBox* ocrPage() const { return m_ocrPage; }
    QVBox* imagePage() const { return m_imgPage; }

    KSpellConfig* spellConfig() const
        { return m_spellConfig; }

    bool wantSpellCheck();

public slots:
    virtual void stopAnimation();
    virtual void startAnimation();

    virtual void introduceImage( KookaImage* );

    virtual void startOCR();
    virtual void stopOCR();
    /**
     * enable or disable dialog fields. This slot is called when the ocr process starts
     * with parameter state=false and called again if the gui should accept user input
     * again after ocr finished with parameter true.
     */
    virtual void enableFields(bool state);

protected:
    /**
     * This creates a a tab OCR in the dialog and creates a small intro about the
     * ocr engine used.
     * It calls the virtual subs ocrEngineName, ocrEngineLogo and ocrEngineDesc which
     * must return the approbiate values for the engines.
     * @return a pointer to a VBox in which further elements can be layouted
     */
    virtual void ocrIntro();

    /**
     * This creates a a tab Image Info in the dialog and creates a image description
     * about the current image to ocr.
     */
    virtual void imgIntro();

    /**
     * This sets up the spellchecking configuration
     */
    virtual void spellCheckIntro();


protected slots:
    virtual KAnimWidget* getAnimation(QWidget*);
    virtual void writeConfig();
    virtual void slSpellConfigChanged();

    /**
     * hit if the user toggles the want-spellcheck checkbox
     */
    virtual void slWantSpellcheck( bool wantIt );

private slots:
    virtual void slPreviewResult( KIO::Job* );
    virtual void slGotPreview( const KFileItem*, const QPixmap& );

private:
    KAnimWidget  *m_animation;
    QVBox        *m_ocrPage;
    QVBox        *m_imgPage;
    QVBox        *m_spellchkPage;
    QVBox        *m_metaBox;
    QHBox        *m_imgHBox;
    QLabel       *m_previewPix;
    KookaImage   *m_currImg;

    KSpellConfig *m_spellConfig;
    bool          m_wantSpellCfg;         /* show the spellcheck options? */
    bool          m_userWantsSpellCheck;  /* user has enabled/disabled spellcheck */
    QSize         m_previewSize;

    QCheckBox     *m_cbWantCheck;
    QGroupBox     *m_gbSpellOpts;
};

#endif