Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

4 files changed, 419 insertions, 0 deletions

diff --git a/kaddressbook/thumbnailcreator/Makefile.am b/kaddressbook/thumbnailcreator/Makefile.am
new file mode 100644
index 00000000..2e37c009
--- /dev/null
+++ b/kaddressbook/thumbnailcreator/Makefile.am
@@ -0,0 +1,15 @@
+# kioslave to generate thumbnails for vCard and LDIF-Files in Konqueror
+INCLUDES = $(all_includes)
+
+kde_module_LTLIBRARIES = ldifvcardthumbnail.la
+
+ldifvcardthumbnail_la_SOURCES = ldifvcardcreator.cpp
+ldifvcardthumbnail_la_LDFLAGS = -module $(KDE_PLUGIN) $(KDE_RPATH) $(all_libraries) -no-undefined
+ldifvcardthumbnail_la_LIBADD = $(LIB_KDECORE) $(LIB_KABC) -lkdefx
+
+noinst_HEADERS = ldifvcardcreator.h
+
+METASOURCES = AUTO
+
+servicesdir = $(kde_servicesdir)
+services_DATA = ldifvcardthumbnail.desktop
diff --git a/kaddressbook/thumbnailcreator/ldifvcardcreator.cpp b/kaddressbook/thumbnailcreator/ldifvcardcreator.cpp
new file mode 100644
index 00000000..4c8a5611
--- /dev/null
+++ b/kaddressbook/thumbnailcreator/ldifvcardcreator.cpp
@@ -0,0 +1,297 @@
+/*
+    This file is part of KAddressBook.
+    Copyright (C) 2003 Helge Deller <deller@kde.org>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    version 2 License 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.
+*/
+
+/*
+ *  - ldifvcardthumbnail -
+ *
+ *  kioslave which generates tumbnails for vCard and LDIF files.
+ *  The thumbnails are used e.g. by Konqueror or in the file selection
+ *  dialog.
+ *
+ */
+
+#include <qdatetime.h>
+#include <qfile.h>
+#include <qpixmap.h>
+#include <qimage.h>
+#include <qpainter.h>
+#include <qtextstream.h>
+
+#include <kdebug.h>
+#include <kglobal.h>
+#include <klocale.h>
+#include <kabc/ldifconverter.h>
+#include <kabc/vcardconverter.h>
+#include <kpixmapsplitter.h>
+#include <kstandarddirs.h>
+#include <kglobalsettings.h>
+
+#include "ldifvcardcreator.h"
+
+extern "C"
+{
+  ThumbCreator *new_creator()
+  {
+    KGlobal::locale()->insertCatalogue( "kaddressbook" );
+    return new VCard_LDIFCreator;
+  }
+}
+
+VCard_LDIFCreator::VCard_LDIFCreator()
+  : mSplitter( 0 )
+{
+}
+
+VCard_LDIFCreator::~VCard_LDIFCreator()
+{
+  delete mSplitter;
+}
+
+
+bool VCard_LDIFCreator::readContents( const QString &path )
+{
+  // read file contents
+  QFile file( path );
+  if ( !file.open( IO_ReadOnly ) )
+    return false;
+
+  QString info;
+  text.truncate(0);
+
+  // read the file
+  QString contents = file.readAll();
+  file.close();
+
+  // convert the file contents to a KABC::Addressee address
+  KABC::AddresseeList addrList;
+  KABC::Addressee addr;
+  KABC::VCardConverter converter;
+
+  addrList = converter.parseVCards( contents );
+  if ( addrList.count() == 0 )
+    if ( !KABC::LDIFConverter::LDIFToAddressee( contents, addrList ) )
+	return false;
+  if ( addrList.count()>1 ) {
+    // create an overview (list of all names)
+    name = i18n("One contact found:", "%n contacts found:", addrList.count());
+    unsigned int no, linenr;
+    for (linenr=no=0; linenr<30 && no<addrList.count(); ++no) {
+       addr = addrList[no];
+       info = addr.formattedName().simplifyWhiteSpace();
+       if (info.isEmpty())
+          info = addr.givenName() + " " + addr.familyName();
+       info = info.simplifyWhiteSpace();
+       if (info.isEmpty())
+         continue;
+       text.append(info);
+       text.append("\n");
+       ++linenr;
+    }
+    return true;
+  }
+
+  // create card for _one_ contact
+  addr = addrList[ 0 ];
+
+  // prepare the text
+  name = addr.formattedName().simplifyWhiteSpace();
+  if ( name.isEmpty() )
+    name = addr.givenName() + " " + addr.familyName();
+  name = name.simplifyWhiteSpace();
+
+
+  KABC::PhoneNumber::List pnList = addr.phoneNumbers();
+  QStringList phoneNumbers;
+  for (unsigned int no=0; no<pnList.count(); ++no) {
+    QString pn = pnList[no].number().simplifyWhiteSpace();
+    if (!pn.isEmpty() && !phoneNumbers.contains(pn))
+      phoneNumbers.append(pn);
+  }
+  if ( !phoneNumbers.isEmpty() )
+      text += phoneNumbers.join("\n") + "\n";
+
+  info = addr.organization().simplifyWhiteSpace();
+  if ( !info.isEmpty() )
+    text += info + "\n";
+
+  // get an address
+  KABC::Address address = addr.address(KABC::Address::Work);
+  if (address.isEmpty())
+    address = addr.address(KABC::Address::Home);
+  if (address.isEmpty())
+    address = addr.address(KABC::Address::Pref);
+  info = address.formattedAddress();
+  if ( !info.isEmpty() )
+    text += info + "\n";
+
+  return true;
+}
+
+
+bool VCard_LDIFCreator::createImageSmall()
+{
+  text = name + "\n" + text;
+
+  if ( !mSplitter ) {
+    mSplitter = new KPixmapSplitter;
+    QString pixmap = locate( "data", "konqueror/pics/thumbnailfont_7x4.png" );
+    if ( pixmap.isEmpty() ) {
+      delete mSplitter;
+      mSplitter=0;
+      kdWarning() << "VCard_LDIFCreator: Font image \"thumbnailfont_7x4.png\" not found!\n";
+      return false;
+    }
+    mSplitter->setPixmap( QPixmap( pixmap ) );
+    mSplitter->setItemSize( QSize( 4, 7 ) );
+  }
+
+  QSize chSize = mSplitter->itemSize(); // the size of one char
+  int xOffset = chSize.width();
+  int yOffset = chSize.height();
+
+  // calculate a better border so that the text is centered
+  int canvasWidth = pixmapSize.width() - 2 * xborder;
+  int canvasHeight = pixmapSize.height() -  2 * yborder;
+  int numCharsPerLine = (int) (canvasWidth / chSize.width());
+  int numLines = (int) (canvasHeight / chSize.height());
+
+  // render the information
+  QRect rect;
+  int rest = mPixmap.width() - (numCharsPerLine * chSize.width());
+  xborder = QMAX( xborder, rest / 2 ); // center horizontally
+  rest = mPixmap.height() - (numLines * chSize.height());
+  yborder = QMAX( yborder, rest / 2 ); // center vertically
+  // end centering
+
+  int x = xborder, y = yborder; // where to paint the characters
+  int posNewLine  = mPixmap.width() - (chSize.width() + xborder);
+  int posLastLine = mPixmap.height() - (chSize.height() + yborder);
+  bool newLine = false;
+  Q_ASSERT( posNewLine > 0 );
+  const QPixmap *fontPixmap = &(mSplitter->pixmap());
+
+  for ( uint i = 0; i < text.length(); i++ ) {
+    if ( x > posNewLine || newLine ) {  // start a new line?
+      x = xborder;
+      y += yOffset;
+
+      if ( y > posLastLine ) // more text than space
+        break;
+
+      // after starting a new line, we also jump to the next
+      // physical newline in the file if we don't come from one
+      if ( !newLine ) {
+        int pos = text.find( '\n', i );
+        if ( pos > (int) i )
+          i = pos +1;
+      }
+
+      newLine = false;
+    }
+
+    // check for newlines in the text (unix,dos)
+    QChar ch = text.at( i );
+    if ( ch == '\n' ) {
+      newLine = true;
+      continue;
+    } else if ( ch == '\r' && text.at(i+1) == '\n' ) {
+      newLine = true;
+      i++; // skip the next character (\n) as well
+      continue;
+    }
+
+    rect = mSplitter->coordinates( ch );
+    if ( !rect.isEmpty() )
+      bitBlt( &mPixmap, QPoint(x,y), fontPixmap, rect, Qt::CopyROP );
+
+    x += xOffset; // next character
+  }
+
+  return true;
+}
+
+bool VCard_LDIFCreator::createImageBig()
+{
+  QFont normalFont( KGlobalSettings::generalFont() );
+  QFont titleFont( normalFont );
+  titleFont.setBold(true);
+  // titleFont.setUnderline(true);
+  titleFont.setItalic(true);
+
+  QPainter painter(&mPixmap);
+  painter.setFont(titleFont);
+  QFontMetrics fm(painter.fontMetrics());
+
+  // draw contact name
+  painter.setClipRect(2, 2, pixmapSize.width()-4, pixmapSize.height()-4);
+  QPoint p(5, fm.height()+2);
+  painter.drawText(p, name);
+  p.setY( 3*p.y()/2 );
+
+  // draw contact information
+  painter.setFont(normalFont);
+  fm = painter.fontMetrics();
+
+  const QStringList list( QStringList::split('\n', text) );
+  for ( QStringList::ConstIterator it = list.begin();
+             p.y()<=pixmapSize.height() && it != list.end(); ++it ) {
+     p.setY( p.y() + fm.height() );
+     painter.drawText(p, *it);
+  }
+
+  return true;
+}
+
+bool VCard_LDIFCreator::create(const QString &path, int width, int height, QImage &img)
+{
+  if ( !readContents(path) )
+    return false;
+
+  // resize the image if necessary
+  pixmapSize = QSize( width, height );
+  if (height * 3 > width * 4)
+    pixmapSize.setHeight( width * 4 / 3 );
+  else
+    pixmapSize.setWidth( height * 3 / 4 );
+
+  if ( pixmapSize != mPixmap.size() )
+    mPixmap.resize( pixmapSize );
+
+  mPixmap.fill( QColor( 245, 245, 245 ) ); // light-grey background
+
+  // one pixel for the rectangle, the rest. whitespace
+  xborder = 1 + pixmapSize.width()/16;  // minimum x-border
+  yborder = 1 + pixmapSize.height()/16; // minimum y-border
+
+  bool ok;
+  if ( width >= 150 /*pixel*/ )
+    ok = createImageBig();
+  else
+    ok = createImageSmall();
+  if (!ok)
+    return false;
+
+  img = mPixmap.convertToImage();
+  return true;
+}
+
+ThumbCreator::Flags VCard_LDIFCreator::flags() const
+{
+  return (Flags)(DrawFrame | BlendIcon);
+}
diff --git a/kaddressbook/thumbnailcreator/ldifvcardcreator.h b/kaddressbook/thumbnailcreator/ldifvcardcreator.h
new file mode 100644
index 00000000..e6ae6ba4
--- /dev/null
+++ b/kaddressbook/thumbnailcreator/ldifvcardcreator.h
@@ -0,0 +1,50 @@
+/*
+    This file is part of KAddressBook.
+    Copyright (C) 2003 Helge Deller <deller@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 VCARD_LDIFCREATOR_H
+#define VCARD_LDIFCREATOR_H
+
+#include <qpixmap.h>
+#include <kio/thumbcreator.h>
+
+class KPixmapSplitter;
+
+class VCard_LDIFCreator : public ThumbCreator
+{
+  public:
+    VCard_LDIFCreator();
+    virtual ~VCard_LDIFCreator();
+    virtual bool create(const QString &path, int width, int height, QImage &img);
+    virtual Flags flags() const;
+
+  private:
+    KPixmapSplitter *mSplitter;
+    QPixmap mPixmap;
+
+    QString name;
+    QString text;
+    bool readContents( const QString &path );
+    int xborder, yborder;
+    QSize pixmapSize;
+    bool createImageSmall();
+    bool createImageBig();
+};
+
+#endif
diff --git a/kaddressbook/thumbnailcreator/ldifvcardthumbnail.desktop b/kaddressbook/thumbnailcreator/ldifvcardthumbnail.desktop
new file mode 100644
index 00000000..2eb63ab5
--- /dev/null
+++ b/kaddressbook/thumbnailcreator/ldifvcardthumbnail.desktop
@@ -0,0 +1,57 @@
+[Desktop Entry]
+Type=Service
+Name=Electronic Business Card Files
+Name[af]=Elektroniese Besigheid kaartjie lêers
+Name[ar]=ملفّات بطاقة الأعمال الإلكترونيّة
+Name[bg]=Файлове за електронна визитка
+Name[bs]=Datoteke elektronskih vizit karti
+Name[ca]=Fitxers targeta de visita electrònica
+Name[cs]=Soubory s elektronickými vizitkami
+Name[cy]=Ffeiliau Cerdyn Busnes Electronig
+Name[da]=Elektroniske forretningskort-filer
+Name[de]=Dateien für elektronische Visitenkarten
+Name[el]=Αρχεία επαγγελματικών ηλεκτρονικών καρτών
+Name[eo]=Dosieroj de Elektronika Vizitkarto
+Name[es]=Archivos de tarjetas de visita electrónicas
+Name[et]=Elektrooniline visiitkaart
+Name[eu]=Electronic Business Card fitxategiak
+Name[fa]=پرونده‌های کارت تجاری الکترونیکی
+Name[fi]=Sähköiset käyntikorttitiedostot
+Name[fr]=Fichiers de cartes de commerce électroniques
+Name[fy]=Elektronyske fisitekaartsjetriemmen
+Name[gl]=Ficheiros de Tarxetas de Visita Electrónicas
+Name[hi]=इलेक्ट्रानिक व्यापार कार्ड फ़ाइलें
+Name[hu]=Elektronikus névjegykártyák
+Name[is]=Skrár með rafrænum nafnspjöldum
+Name[it]=Biglietto da visita elettronico
+Name[ja]=電子ビジネスカードファイル
+Name[ka]=ელექტრონული სავიზიტო ბარათების ფაილები
+Name[kk]=Электрондық визитка файлдары
+Name[km]=ឯកសារ​នាមប័ណ្ណ​អេឡិចត្រូនិច
+Name[lt]=Elektroninės verslo kortelės bylos
+Name[mk]=Датотеки со електронски деловни картички
+Name[ms]=Fail Kad Perniagaan Elektronik
+Name[nb]=Filer for elektroniske visittkort
+Name[nds]=Dateien mit elektroonsche Visitenkoorten
+Name[ne]=बिद्युतीय व्यवसायीक कार्ड फाइल
+Name[nl]=Elektronische visitekaartbestanden
+Name[nn]=Filer for elektroniske visittkort
+Name[pl]=Pliki elektronicznych wizytówek
+Name[pt]=Ficheiros de Cartões Profissionais Electrónicos
+Name[pt_BR]=Arquivos de Cartão de Visita Eletrônico
+Name[ru]=Файлы электронных визиток
+Name[sk]=Súbory elektronických vizitiek
+Name[sl]=Datoteke elektronskih vizitk
+Name[sr]=Фајлови електронске пословне картице
+Name[sr@Latn]=Fajlovi elektronske poslovne kartice
+Name[sv]=Elektroniska visitkortsfiler
+Name[ta]=மின்னணு தொழில் அட்டை கோப்புகள்
+Name[tg]=Файлҳои визиткаи электронӣ
+Name[tr]=Elektronik İş Kartı Dosyaları
+Name[uk]=файли електронних візитних карток
+Name[zh_CN]=电子名片文件
+Name[zh_TW]=電子名片檔
+ServiceTypes=ThumbCreator
+MimeTypes=text/x-vcard,text/x-ldif
+X-KDE-Library=ldifvcardthumbnail
+CacheThumbnail=false