/* * 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(TQWidget *parent, const char *name) : KPrintDialogPage(parent,name) { //WhatsThis strings.... (added by pfeifle@kde.org) TQString 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. (TDEPrint " " 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).

" " " "
" ); TQString whatsThisRemoveFilterButton = i18n(" Remove Filter button" "

This button removes the highlighted filter from the" " list of filters." " " ); TQString 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.

" "
" ); TQString 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..

" "
" ); TQString whatsThisConfigureFilterButton = i18n( " Configure Filter button" "

This button lets you configure the currently highlighted filter." " It opens a separate dialog. " "

" "
" ); TQString 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 TDEPrint 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.
  • " "
" "

" "
" ); TQString 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 TDEPrint. 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.

" "

TDEPrint can utilize any external filtering program which you may find useful " " through this interface.

" "

TDEPrint ships preconfigured with support for a selection of common filters. These " " filters however need to be " " installed independently from TDEPrint. These pre-filters work for all print subsystems" " supported by TDEPrint (such as CUPS, LPRng and LPD), because they are not depending on these.

" ".

Amongst the pre-configured filters shipping with TDEPrint 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 TDEPrint " " pre-filters. " "

" "
" ); setTitle(i18n("Filters")); m_activefilters.setAutoDelete(true); m_valid = true; m_view = new TDEListView(this); TQWhatsThis::add(m_view, whatsThisFilterchainListView); m_view->addColumn(""); m_view->setFrameStyle(TQFrame::WinPanel|TQFrame::Sunken); m_view->setLineWidth(1); m_view->setSorting(-1); m_view->header()->hide(); connect(m_view,TQT_SIGNAL(selectionChanged(TQListViewItem*)),TQT_SLOT(slotItemSelected(TQListViewItem*))); m_add = new TQToolButton(this); TQWhatsThis::add(m_add, whatsThisAddFilterButton); m_add->setIconSet(BarIconSet("filter")); TQToolTip::add(m_add, i18n("Add filter")); m_remove = new TQToolButton(this); TQWhatsThis::add(m_remove, whatsThisRemoveFilterButton); m_remove->setIconSet(BarIconSet("remove")); TQToolTip::add(m_remove, i18n("Remove filter")); m_up = new TQToolButton(this); TQWhatsThis::add(m_up, whatsThisMoveFilterUpButton); m_up->setIconSet(BarIconSet("go-up")); TQToolTip::add(m_up, i18n("Move filter up")); m_down = new TQToolButton(this); TQWhatsThis::add(m_down, whatsThisMoveFilterDownButton); m_down->setIconSet(BarIconSet("go-down")); TQToolTip::add(m_down, i18n("Move filter down")); m_configure = new TQToolButton(this); TQWhatsThis::add(m_configure, whatsThisConfigureFilterButton); m_configure->setIconSet(BarIconSet("configure")); TQToolTip::add(m_configure, i18n("Configure filter")); connect(m_add,TQT_SIGNAL(clicked()),TQT_SLOT(slotAddClicked())); connect(m_remove,TQT_SIGNAL(clicked()),TQT_SLOT(slotRemoveClicked())); connect(m_up,TQT_SIGNAL(clicked()),TQT_SLOT(slotUpClicked())); connect(m_down,TQT_SIGNAL(clicked()),TQT_SLOT(slotDownClicked())); connect(m_configure,TQT_SIGNAL(clicked()),TQT_SLOT(slotConfigureClicked())); connect(m_view,TQT_SIGNAL(doubleClicked(TQListViewItem*)),TQT_SLOT(slotConfigureClicked())); m_info = new KActiveLabel(this); TQWhatsThis::add(m_info, whatsThisFilterInfoPane); m_info->setVScrollBarMode( TQScrollView::Auto ); m_info->setHScrollBarMode( TQScrollView::Auto ); m_info->setFrameStyle( TQFrame::Panel|TQFrame::Sunken ); m_info->setMinimumSize( TQSize( 240, 100 ) ); TQGridLayout *l1 = new TQGridLayout(this, 2, 2, 0, KDialog::spacingHint()); l1->setColStretch(0, 1); TQVBoxLayout *l2 = new TQVBoxLayout(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() { /* TQListViewItem *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; TQString choice = KXmlCommandManager::self()->selectCommand( this ); ok = !choice.isEmpty(); if (ok) { KXmlCommand *cmd = KXmlCommandManager::self()->loadCommand(choice); if (!cmd) return; // Error TQStringList filters = activeList(); int pos = KXmlCommandManager::self()->insertCommand(filters, cmd->name()); TQListViewItem *prev(0); if (pos > 0) { prev = m_view->firstChild(); for (int i=1;prev && inextSibling(); } m_activefilters.insert(cmd->name(), cmd); TQListViewItem *item = new TQListViewItem(m_view, prev, cmd->description(), cmd->name()); item->setPixmap(0, SmallIcon("filter")); checkFilterChain(); } } void KPFilterPage::slotRemoveClicked() { if (m_view->selectedItem()) { TQString 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() { TQListViewItem *item = m_view->selectedItem(); if (item && item->itemAbove()) { TQListViewItem *clone = new TQListViewItem(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() { TQListViewItem *item = m_view->selectedItem(); if (item && item->itemBelow()) { TQListViewItem *clone = new TQListViewItem(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(TQListViewItem *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 TQMap& opts) { TQStringList filters = TQStringList::split(',',opts["_kde-filters"],false); // remove unneeded filters TQDictIterator 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(); TQListViewItem *item(0); for (TQStringList::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 TQListViewItem(m_view,item,f->description(),f->name()); } checkFilterChain(); } void KPFilterPage::getOptions(TQMap& opts, bool incldef) { TQStringList filters = activeList(); for (TQStringList::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(","); } } TQStringList KPFilterPage::activeList() { TQStringList list; TQListViewItem *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() { TQListViewItem *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(TQString& 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() { TQString txt; KXmlCommand *f = currentFilter(); if (f) { TQString 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"