/*
* This file is part of the KDE libraries
* Copyright (c) 2001 Michael Goffioul
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License version 2 as published by the Free Software Foundation.
*
* 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.
**/
#include "kpfilterpage.h"
#include "kmfactory.h"
#include "kxmlcommand.h"
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
KPFilterPage::KPFilterPage(QWidget *parent, const char *name)
: KPrintDialogPage(parent,name)
{
//WhatsThis strings.... (added by pfeifle@kde.org)
QString whatsThisAddFilterButton = i18n( " Add Filter button"
" This button calls a little dialog to let you"
" select a filter here.
"
" Note 1: You can chain different filters as long as you make "
" sure that the output of one fits as input of the next. (KDEPrint "
" checks your filtering chain and will warn you if you fail to do so.
"
" Note 2: The filters you define here are applied to your jobfile "
" before it is handed downstream to your spooler and print "
" subsystem (e.g. CUPS, LPRng, LPD).
"
" "
" " );
QString whatsThisRemoveFilterButton = i18n(" Remove Filter button"
" This button removes the highlighted filter from the"
" list of filters."
"
" );
QString whatsThisMoveFilterUpButton = i18n(" Move Filter Up button"
" This button moves the highlighted filter up in the list"
" of filters, towards the front of the filtering chain.
"
" " );
QString whatsThisMoveFilterDownButton = i18n(" Move Filter Down button"
" This button moves the highlighted filter down in the list"
" of filters, towards the end of the filtering chain..
"
" " );
QString whatsThisConfigureFilterButton = i18n( " Configure Filter button"
" This button lets you configure the currently highlighted filter."
" It opens a separate dialog. "
"
"
" " );
QString whatsThisFilterInfoPane = i18n( " Filter Info Pane"
" This field shows some general info about the selected filter. "
" Amongst them are: "
"
"
" - the filter name (as displayed in the KDEPrint user interface);
"
" - the filter requirements (that is the external program that needs "
" to present and executable on this system);
"
" - the filter input format (in the form of one or several MIME types"
" accepted by the filter);
"
" - the filter output format (in the form of a MIME type "
" generated by the filter);
"
" - a more or less verbose text describing the filter's operation.
"
"
"
"
"
" " );
QString whatsThisFilterchainListView = i18n( " Filtering Chain (if enabled, is run before actual "
" job submission to print system)"
" This field shows which filters are currently selected to act as 'pre-filters' "
" for KDEPrint. Pre-filters are processing the print files before they are "
" send downstream to your real print subsystem.
"
" The list shown in this field may be empty (default).
"
" The pre-filters act on the printjob in the order they are listed (from top to bottom). "
" This is done by acting as a filtering chain where the output of one filter "
" acts as input to the next. By putting the filters into the wrong order, you can make "
" the filtering chain fail. For example: if your file is ASCII text, and you want the "
" output being processed by the 'Multipage per Sheet' filter, the first filter must be "
" one that processes ASCII into PostScript.
"
" KDEPrint can utilize any external filtering program which you may find useful "
" through this interface.
"
" KDEPrint ships preconfigured with support for a selection of common filters. These "
" filters however need to be "
" installed independently from KDEPrint. These pre-filters work for all print subsystems"
" supported by KDEPrint (such as CUPS, LPRng and LPD), because they are not depending on these.
"
". Amongst the pre-configured filters shipping with KDEPrint are:
"
" "
" - the Enscript text filter
"
" - a Multiple Pages per Sheet filter "
"
- a PostScript to PDF converter.
"
" - a Page Selection/Ordering filter.
"
" - a Poster Printing filter.
"
" - and some more..
"
"
"
" To insert a filter into this list, simply click on the funnel icon (topmost on "
" the right icon column group) and proceed. "
" Please click on the other elements of this dialog to learn more about the KDEPrint "
" pre-filters. "
"
"
" " );
setTitle(i18n("Filters"));
m_activefilters.setAutoDelete(true);
m_valid = true;
m_view = new KListView(this);
QWhatsThis::add(m_view, whatsThisFilterchainListView);
m_view->addColumn("");
m_view->setFrameStyle(QFrame::WinPanel|QFrame::Sunken);
m_view->setLineWidth(1);
m_view->setSorting(-1);
m_view->header()->hide();
connect(m_view,SIGNAL(selectionChanged(QListViewItem*)),SLOT(slotItemSelected(QListViewItem*)));
m_add = new QToolButton(this);
QWhatsThis::add(m_add, whatsThisAddFilterButton);
m_add->setIconSet(BarIconSet("filter"));
QToolTip::add(m_add, i18n("Add filter"));
m_remove = new QToolButton(this);
QWhatsThis::add(m_remove, whatsThisRemoveFilterButton);
m_remove->setIconSet(BarIconSet("remove"));
QToolTip::add(m_remove, i18n("Remove filter"));
m_up = new QToolButton(this);
QWhatsThis::add(m_up, whatsThisMoveFilterUpButton);
m_up->setIconSet(BarIconSet("up"));
QToolTip::add(m_up, i18n("Move filter up"));
m_down = new QToolButton(this);
QWhatsThis::add(m_down, whatsThisMoveFilterDownButton);
m_down->setIconSet(BarIconSet("down"));
QToolTip::add(m_down, i18n("Move filter down"));
m_configure = new QToolButton(this);
QWhatsThis::add(m_configure, whatsThisConfigureFilterButton);
m_configure->setIconSet(BarIconSet("configure"));
QToolTip::add(m_configure, i18n("Configure filter"));
connect(m_add,SIGNAL(clicked()),SLOT(slotAddClicked()));
connect(m_remove,SIGNAL(clicked()),SLOT(slotRemoveClicked()));
connect(m_up,SIGNAL(clicked()),SLOT(slotUpClicked()));
connect(m_down,SIGNAL(clicked()),SLOT(slotDownClicked()));
connect(m_configure,SIGNAL(clicked()),SLOT(slotConfigureClicked()));
connect(m_view,SIGNAL(doubleClicked(QListViewItem*)),SLOT(slotConfigureClicked()));
m_info = new KActiveLabel(this);
QWhatsThis::add(m_info, whatsThisFilterInfoPane);
m_info->setVScrollBarMode( QScrollView::Auto );
m_info->setHScrollBarMode( QScrollView::Auto );
m_info->setFrameStyle( QFrame::Panel|QFrame::Sunken );
m_info->setMinimumSize( QSize( 240, 100 ) );
QGridLayout *l1 = new QGridLayout(this, 2, 2, 0, KDialog::spacingHint());
l1->setColStretch(0, 1);
QVBoxLayout *l2 = new QVBoxLayout(0, 0, 1);
l1->addWidget(m_view, 0, 0);
l1->addLayout(l2, 0, 1);
l2->addWidget(m_add);
l2->addWidget(m_remove);
l2->addSpacing(5);
l2->addWidget(m_up);
l2->addWidget(m_down);
l2->addSpacing(5);
l2->addWidget(m_configure);
l2->addStretch(1);
l1->addMultiCellWidget(m_info, 1, 1, 0, 1);
slotItemSelected(0);
resize(100,50);
}
KPFilterPage::~KPFilterPage()
{
}
void KPFilterPage::updateButton()
{
/* QListViewItem *item = m_view->currentItem();
bool state=(item!=0);
m_remove->setEnabled(state);
m_up->setEnabled((state && item->itemAbove() != 0));
m_down->setEnabled((state && item->itemBelow() != 0));
m_configure->setEnabled(state);*/
}
void KPFilterPage::slotAddClicked()
{
bool ok;
QString choice = KXmlCommandManager::self()->selectCommand( this );
ok = !choice.isEmpty();
if (ok)
{
KXmlCommand *cmd = KXmlCommandManager::self()->loadCommand(choice);
if (!cmd) return; // Error
QStringList filters = activeList();
int pos = KXmlCommandManager::self()->insertCommand(filters, cmd->name());
QListViewItem *prev(0);
if (pos > 0)
{
prev = m_view->firstChild();
for (int i=1;prev && inextSibling();
}
m_activefilters.insert(cmd->name(), cmd);
QListViewItem *item = new QListViewItem(m_view, prev, cmd->description(), cmd->name());
item->setPixmap(0, SmallIcon("filter"));
checkFilterChain();
}
}
void KPFilterPage::slotRemoveClicked()
{
if (m_view->selectedItem())
{
QString idname = m_view->selectedItem()->text(1);
delete m_view->selectedItem();
m_activefilters.remove(idname);
checkFilterChain();
if (m_view->currentItem())
m_view->setSelected(m_view->currentItem(), true);
slotItemSelected(m_view->currentItem());
}
}
void KPFilterPage::slotUpClicked()
{
QListViewItem *item = m_view->selectedItem();
if (item && item->itemAbove())
{
QListViewItem *clone = new QListViewItem(m_view,item->itemAbove()->itemAbove(),item->text(0),item->text(1));
clone->setPixmap(0, SmallIcon("filter"));
delete item;
m_view->setSelected(clone, true);
checkFilterChain();
}
}
void KPFilterPage::slotDownClicked()
{
QListViewItem *item = m_view->selectedItem();
if (item && item->itemBelow())
{
QListViewItem *clone = new QListViewItem(m_view,item->itemBelow(),item->text(0),item->text(1));
clone->setPixmap(0, SmallIcon("filter"));
delete item;
m_view->setSelected(clone, true);
checkFilterChain();
}
}
void KPFilterPage::slotConfigureClicked()
{
KXmlCommand *filter = currentFilter();
if (!filter || !KXmlCommandManager::self()->configure(filter, this))
KMessageBox::error(this,i18n("Internal error: unable to load filter."));
}
void KPFilterPage::slotItemSelected(QListViewItem *item)
{
m_remove->setEnabled((item != 0));
m_up->setEnabled((item != 0 && item->itemAbove() != 0));
m_down->setEnabled((item != 0 && item->itemBelow() != 0));
m_configure->setEnabled((item != 0));
updateInfo();
}
void KPFilterPage::setOptions(const QMap& opts)
{
QStringList filters = QStringList::split(',',opts["_kde-filters"],false);
// remove unneeded filters
QDictIterator dit(m_activefilters);
for (;dit.current();)
{
if (filters.find(dit.currentKey()) == filters.end())
m_activefilters.remove(dit.currentKey());
else
{
dit.current()->setOptions(opts);
++dit;
}
}
// add needed filters
m_view->clear();
QListViewItem *item(0);
for (QStringList::ConstIterator sit=filters.begin(); sit!=filters.end(); ++sit)
{
KXmlCommand *f(0);
if ((f=m_activefilters.find(*sit)) == 0)
{
f = KXmlCommandManager::self()->loadCommand(*sit);
if (f)
{
m_activefilters.insert(*sit,f);
f->setOptions(opts);
}
}
if (f)
item = new QListViewItem(m_view,item,f->description(),f->name());
}
checkFilterChain();
}
void KPFilterPage::getOptions(QMap& opts, bool incldef)
{
QStringList filters = activeList();
for (QStringList::ConstIterator it=filters.begin(); it!=filters.end(); ++it)
{
KXmlCommand *f = m_activefilters.find(*it);
if (f)
f->getOptions(opts, incldef);
}
if (filters.count() > 0 || incldef)
{
opts["_kde-filters"] = filters.join(",");
}
}
QStringList KPFilterPage::activeList()
{
QStringList list;
QListViewItem *item = m_view->firstChild();
while (item)
{
list.append(item->text(1));
item = item->nextSibling();
}
return list;
}
KXmlCommand* KPFilterPage::currentFilter()
{
KXmlCommand *filter(0);
if (m_view->selectedItem())
filter = m_activefilters.find(m_view->selectedItem()->text(1));
return filter;
}
void KPFilterPage::checkFilterChain()
{
QListViewItem *item = m_view->firstChild();
bool ok(true);
m_valid = true;
while (item)
{
item->setPixmap(0, (ok ? SmallIcon("filter") : SmallIcon("filterstop")));
KXmlCommand *f1 = m_activefilters.find(item->text(1));
if (f1 && item->nextSibling())
{
KXmlCommand *f2 = m_activefilters.find(item->nextSibling()->text(1));
if (f2)
{
if (!f2->acceptMimeType(f1->mimeType()))
{
item->setPixmap(0, SmallIcon("filterstop"));
ok = false;
m_valid = false;
}
else
ok = true;
}
}
item = item->nextSibling();
}
}
bool KPFilterPage::isValid(QString& msg)
{
if (!m_valid)
{
msg = i18n("The filter chain is wrong. The output format of at least one filter is not supported by its follower. See Filters tab for more information.
");
}
return m_valid;
}
void KPFilterPage::updateInfo()
{
QString txt;
KXmlCommand *f = currentFilter();
if (f)
{
QString templ("%1: %2
");
txt.append(templ.arg(i18n("Name")).arg(f->name()));
txt.append(templ.arg(i18n("Requirements")).arg(f->requirements().join(", ")));
txt.append(templ.arg(i18n("Input")).arg(f->inputMimeTypes().join(", ")));
txt.append(templ.arg(i18n("Output")).arg(f->mimeType()));
if ( !f->comment().isEmpty() )
txt.append( "
" ).append( f->comment() );
}
m_info->setText(txt);
}
#include "kpfilterpage.moc"