Herd Software Entwicklung
DaVinci Grafikbibliothek
DaVinci Dokumentation

Umstieg von Version 2.x

Beim Übergang von DaVinci Version 2.x auf Version 3.x wurde das API von DaVinci grundlegend verändert. Dies macht Änderungen an den Quellcodes und Installationsprozeduren von existierenden Programmen notwendig, die DaVinci Version 3 nutzen wollen.

Neue und aufgewertete Funktionen In Version 3.x

• DaVinci steht nun als VCL-Komponente und ActiveX zur Verfügung.
  
  
• Drehen von MetaDateien und Enhanced MetaFiles
  
  
• Unterstützung von enhanced Metafiles
  
  
• Unterstützung von CMYK-Dateien
  
  
• Unterstützung von RGBA-Dateien
  
  
• Vereinfachtes TWAIN API TWAINGetImage
  
  
• TWAIN-Scanvorgang ohne Benutzereingriff TWAINAquireExt
  
  
• Der Rückgabewert der fnPoint-Callbackroutine der TransformDIB-Routine wurde erweitert.
  
  
• Neue Funktion StretchDIB2DIBBlt kopiert einen Ausschnitt aus einer Quell-DIB in einern Ausschnitt einer Ziel-DIB.
  
  
• Die DitherTox-Funktionen zur Verringerung der Farbtiefe einer DIB können nun auch Quell-DIBs mit einer Farbtiefe von 16 Bit/Pixel verarbeiten (HighColor)
  
  
• Die neue Funktion DitherTo1 erlaubt das Rastern von Farbbildern zu monochromen Bildern.
  
  
• Die Funktion Splineline zieht eine gebogene Linie basierend auf von der Anwendung übergebenen Stützpunkten.
  
  
• Der Import von DXF-Grafiken kann direkt als Enhanced Metafile erfolgen, wodurch eine höhere Auflösung erreicht werden kann.
  
  
• Funktionen GammaCorrectionGetArray und GammaCorrectionApplyToDIB sowie Parameter lpawGammaCorrection zur Routine DitherTo1 zur Gamma-Korrektur.
  
  
• Viele DaVinci / Leonardo-Funktionen bieten nun für Sonderfälle Optimierungen mit erhöhter Arbeitsgeschwindigkeit an.
  
  
• Import von TIFF-Dateien mit 16 Bits / Pixel (R,G,B und Grauwerte). Pro:Version zusätzlich optional Import und Export ohne Datenverlust der zusätzlichen 8 Bits durch Import als 48-Bit DIB (Außerhalb der Microsoft-Spezifikation für DIBs).
  
  
• Die Ausführung der Funktion TransformDIB zur Erstellung von 8, 4 und 1-Bit DIBs wurde beschleunigt.
  
  
• Es wird nun der Import von Grafiken im Format "Encapsulated Postscript" (.EPS) unterstützt.
  
  
• Die DitherTo8 – Funktion verwendet nun eine Standardpalette mit zusätzlich 17 Graustufen so daß die Qualität der gerasterten Bilder steigt.
  
  
• Beim Export von TIFF-Dateien erkennt DaVinci nun automatisch DIBs mit Grauwertpalette und speichert diese als TIFF-Datei mit Grauwert-Kennung anstelle von TIFF-Dateien mit Farbpalette.
  
  
• Die Funktion DIBInfo erhielt einen weiteren Übergabeparameter.
  
  
• RWxxxx Neue Gruppe von Funktionen zum Pixelweisen DIB-Zugriff
  
  
• DIBSelectColors optimiert Farbpaletten beim Rastern von TrueColor auf 256 Farben mit maximal möglicher Qualität.
  
  
• DIBDetectBarCode erkennt Strichcodes in Bitmap-Grafiken.
  
  
• Die neuen Funktionen ipImportInd und ipExportInd arbeiten zusammen mit der DAVPARAMS-Struktur um der Anwendung eine genauere Kontrolle des Import/Exportvorganges zu gestatten und die Programmierung zu vereinfachen.
  
  
• Die Funktion ipTif2DibExt entfällt, ihre Funktion wird nun von ipImportInd erfüllt.
  
  
• Die Funktion ipTifPageCount erwartet jetzt eine MMIO-File Handle anstelle eines Dateinamens der TIFF-Datei.
  
  
• Das Feld bbox der METARESOLUTION – Struktur ist nun unter WIN32 ein RECT-Wert anstelle einer unbenannten Struktur von 16-Bit Integer-werten.
  
  
• Der Rückgabewert für Fehlercodes in C wurde von ipe in IPERROR umbenannt. Die IPE_xxxx Fehlercodes wurden neu organisiert.
  
  
• Größenangaben bei der Umwandlung von MetaFiles in DIBs erfolgen jetzt in Dot Per Inch DPI anstelle von Pixeln.

DLL-Benennung

Um Konflikte mit Programmen, die auf DaVinci Version 2.x basieren, zu vermeiden, wurden alle DaVinci DLL-Dateien umbenannt,

Dementsprechend verändern sich auch die Namen der .LIB-Dateien, mit denen Applikationen gebunden werden müssen.

Funktionsnamen

• Der Begriff DIB (Device Independend Bitmap) wird nun in allen Funktionsnamen grundsätzlich in Großbuchstaben geschrieben:
  
  
• Alle Funktionen zum Umgang mit DIB-Objekten enthalten nun mindestens ein DIB im Funktionsnamen.

  K · Die Funktion "DibNumColors" wurde in "DIBNumPaletteColors" umbenannt, da sie nicht die tatsächliche Anzahl möglicher Farben in einer DIB, sondern lediglich die Anzahl der für Farbpaletten reservieren RGBQUAD-.Strukturen in der DIB zurückliefert.

  K · Die bisherigen Funktionen ipImport und ipExport wurden gestrichen. Neuere Anwendungen sollten die Funktionen ipImportExt und ipExportExt verwenden.

• Die Callback-Funktionen haben nun weitere Übergabeparameter

  K · Die Funktion ConvertDIB32 wurde durch die Funktion ConvertDIB mit erweiterten Möglichkeiten ersetzt.

Unterscheidung in Professional und Standard-Version

Um anspruchsvollen Anwendern mehr Leistung bieten zu können, ohne den Preis für Anwender die nur Basisfunktionen benötigen, zu erhöhen, wird DaVinci ab Version 3.0 in einer Pro und einer Standard-Version angeboten.

Folgende Funktionen von DaVinci 2.x stehen nur in der Pro-Version zur Verfügung

• Alle TWAIN-Funktionen
  
  
• Schnelle 32-Bit DIB-Konvertierung (Optimierung in Funktion "ConvertDIB", Flag IPDIBF_IMPORT_32BIT)
  
  
• Multipage TIFF Support (Funktion ipTifPageCount)
  
  
• Statisch bindbare LIB-Bibliotheken für Borland C++

Lizenzrechtliche Veränderungen

DaVinci wird jetzt für 16-Bit und 32-Bit Version getrennt lizenziert.

Verwendung von MMIO File handles

Die Import/Exportfunktionen von DaVinci bieten nun die Möglichkeit, Datenaustausch mit bereits geöffneten Dateien oder direkt vom/zum Hauptspeicher durchzuführen. Dazu erhielten die Funktionen anstelle eines Dateinamen-Parameters nun einen Parameter vom Typ HMMIO zur Angabe eines MMIO File-Handles.

Fehlerbehandlung

Funktionen der mittleren Ebene (wie ipTif2DIB) sind nun nicht mehr dazu in der Lage, Fehlermeldungen automatisch als Dialog auszugeben, einen Fortschrittsbalken anzuzeigen oder den Wartecursor zu setzen. Alle Routinen der mittleren Ebene geben Fehlercodes nun nach den Konventionen wie bei ipImportExt zurück, d.h. der Rückgabewert ist 0 bei fehlerfreier Ausführung und sonst ein IPE_xxx Fehlercode.