Struktur DAVPARAMS
Achtung! Diese Seite ist Teil der noch unvollständigen Dokumentation der Alpha-Version von DaVinci 4.
Die Struktur DAVPARAMS wird zum Austausch von Daten zwischen dem Anwendungsprogramm und DaVinci während des Imports oder Exports von Grafiken verwendet.
|
typedef struct { |
||
|
// Von der Applikation bereitgestellte Eingabewerte |
||
|
DWORD |
dwStructSize; |
|
|
LPARAM |
lParam; |
|
|
IPCALLBACKPROC |
fnCallbackProc; |
|
|
DWORD |
dwFlags; |
|
|
IStream * |
stream; |
|
|
UINT |
uPageNumber; |
|
|
LPSTR |
lpszFileName; |
|
|
DWORD |
dwFileType; |
|
|
LPSTR |
lpszFltFileName; |
|
|
int |
iDxfRotAngle; |
|
|
int |
iDxfScale; |
|
|
HWND |
hwOwner; |
|
|
POINT |
ptMetaDIBResolution; |
|
|
// Ausgabewerte von Import-Funktionen, Eingabewerte von Export-Funktionen |
||
|
HDIB |
hDIB; |
|
|
HMETAFILE |
hMetaFile; |
|
|
HENHMETAFILE |
hEnhMetaFile; |
|
|
MetaResolution; |
||
|
// Zusatzinformationen |
||
|
DWORD |
dwDxfFlags; |
|
|
DWORD |
dwDIBFlags; |
|
|
DWORD |
dwTransparentColorIndex; |
|
|
BYTE |
abReserved[52]; |
|
|
} DAVPARAMS, FAR *LPDAVPARAMS, NEAR *NPDAVPARAMS; |
||
|
Die DAVPARAMS-Struktur hat folgende Felder: |
||
|
Feld | Typ | Beschreibung | |
|
dwStructSize | DWORD | Größe der Struktur DAVPARAMS in Bytes. Die Anwendung sollte die Größe dieser Struktur immer mit sizeof(DAVPARAMS) setzen, bevor sie eine DaVinci-Funktion aufruft, | |
|
lParam | LPARAM | anwendungsdefinierter 32-Bit-Wert zur Verwendung im Callback fnCallBackProc | |
|
fnCallBackProc | IPCALLBACKPROC | anwendungsdefinierte Callbackfunktion, die von DaVinci ab und zu während des Import/Exports aufgerufen wird und Benutzereingaben verarbeiten oder einen Fortschrittsbalken pflegen kann, | |
|
dwFlags | DWORD | IPF_xxxx Schalterwerte mit Logischem oder kombiniert, | |
|
stream | IStream * | Zeiger auf ein Objekt mit IStream Interface über das die Datei ein/ausgaben erfolgen sollen. | |
|
uPageNumber | int |
Die Standard-Version importiert immer die erste Seite. | |
|
lpszFileName | LPSTR | Dateiname einer zu importierenden Datei, | |
|
dwFileType | DWORD | IPT_xxxx Dateityp, meist IPT_SELECT, | |
|
lpszFltFileName | LPSTR | Dateiname eines .FLT Importfilters wenn dwFileType = IPT_FLT. | |
|
iDxfRotAngle | int | Drehwinkel beim Import von DXF-Dateien, | |
|
iDxfScale | int | Skalierungsfaktor beim Import von DXF-Dateien, | |
|
hwOwner | HWND | Fensterhandle der aufrufenden Anwendung zur Zuordnung des Dateidialogs und des automatisch dargestellten Fortschrittsbalkens, | |
|
ptMetaDIBResolution | POINT | Größenangabe die beim Konvertieren von MetaFile-Daten in Bitmap-Daten benutzt wird um die Anzahl der Pixel der zu erstellenden Bitmap festzulegen. Die Angabe erfolgt in Pixel / Inch, | |
|
hDIB | HDIB | Handle der zu exportierenden DIB bzw. Handle der importierten DIB, | |
|
hMetaFile | HMETAFILE | Handle des zu exportierenden MetaFiles bzw. Handle des importierten MetaFiles, | |
|
hEnhMetaFile | HENMETAFILE | Handle des zu exportierenden Enhanced MetaFiles bzw. Handle des importierten Enhanced MetaFiles, | |
|
MetaResolution | Struktur mit metrischen Größenangaben als Zusatzangaben zu hMetaFile, | ||
|
dwDxfFlags | DWORD | zusätzliche IPDXF_xxxx Flags für den DXF-Import, | |
|
dwDIBFlags | DWORD | zusätzliche IPDIBF_xxxx - Flags geben den typ der zu erstellenden DIB beim Import von Bitmap-Daten an (32-Bit, CMYK, RGBA etc.) | |
|
dwTransparentColorIndex | DWORD | Gibt bei GIF und PNG-Dateien den Index der transparenten Farbe in der Farbtabelle an. 0 bedeutet: Keine Transparenz. Ansonsten wird das Bit 31 gesetzt und die unteren 8 Bit geben die Nummer des Farbpaletteneintrags an. Beachten Sie, daß das PNG-Format Transparenz sowohl als RGBA-Transparenz als auch als indizierte Transparenz wie beim GIF-Format ermöglicht. | |
|
abReserved | BYTE [52] | 52 Bytes reserviert für zukünftige Erweiterungen |
Anmerkungen
Die Funktionen ipImportInd und ipExportInderlauben die Angabe einer DAVPARAMS-Struktur als einfache Übergabeparameter zur Steuerung des Import/Exportvorgangs. Nur bei diesen Funktionen kann die Anwendung selbst einen Zeiger auf eine DAVPARAMS-Struktur vorgeben.
Andere DaVinci Funktionen erfordern die Zuordnung eines Zeigers auf eine DAVPARAMS-Struktur mit der Funktion ipDavParamsAlloc, um Versionssicherheit mit zukünftigen DaVinci-Updates zu gewährleisten.
Von der Anwendung nicht benötigte Strukturelemente sollten mit 0 initialisiert werden. Das Feld dwStructSize ist grundsätzlich immer auszufüllen.
Beispiele
C-Beispiel
|
DAVPARAMS |
par; |
|
memset(&par, 0, sizeof(par)); |
|
|
par.dwStructSize = sizeof(par); |
|
|
Pascal-Beispiel |
|
|
var par |
: DAVPARAMS; |
|
begin |
|
|
FillChar(par, sizeof(par), 0); |
|
|
par.dwStructSize := sizeof(par); |
|