Užívateľské rozhranie pre import vektorových formátov do schém vyžaduje sadu troch funkcií zapuzdrených do dynamickej knižnice (DLL). Tieto funkcie volá proces D2000 GrEditor pri požiadavke o import do otvorenej schémy. Môžeme ich rozdeliť nasledovne:
Identifikačná funkcia GetFileType (v Stdcall volacej konvencií _GetFileType@8) dodáva popis importného formátu a typ prípony importného súboru vo forme dvoch adries ukazujúcich na 1. znak textového reťazca ukončeného nulou. Tieto texty sa použijú pri výbere importného súboru. Napr. Texty "Autocad DXF" a "DXF" budú vo výberovom okne zložené do textu "Autocad DXF (*.DXF)" a budú označovať požiadavku na súbory s príponou "DXF".
Tvar funkcie vo formátoch prekladačov "ADA" a "C":
procedure GetFileType(description,extension: out address);
void _stdcall GetFileType(char far * description,char far * extension)
Parameter | Popis parametra |
---|---|
description | Výstupný parameter - pointer na text obsahujúci popis importného formátu. Môže obsahovať maximálne 80 znakov. |
extension | Výstupný parameter - pointer na text obsahujúci typ prípony importného súboru. Môže obsahovať maximálne 12 znakov. |
Pomocou inicializačnej funkcie ImportConnect(v Stdcall volacej konvencii _ImportConnect@8) sú do importnej DLL prenesené adresy call-back procedúr. Tieto procedúry umožňujú vytvorenie grafických objektov schémy, nastavenie ich parametrov a zobrazenie informácií o stave importu.
Tvar funkcie vo formátoch prekladačov "ADA" a "C":
procedure ImportConnect(procType:integer; procAddr :address);
void _stdcall ImportConnect(int procType,int procAddr )
Parameter | Popis parametra |
---|---|
procType | Vstupný parameter - typ call-back procedúry. |
procAddr | Vstupný parameter - adresa call-back procedúry. |
Implementácia tejto procedúry vyžaduje odpamätať si tie odkazy, ktoré bude ovládač používať vo volaní výkonnej funkcie. Popis hodnôt vstupného parametra procType a popis funkcií sú v kapitole call-back procedúry.
Výkonná funkcia ImportFile (v Stdcall volacej konvencií _ImportFile@16) zabezpečuje import súboru do zadaných rozmerov schémy. Funkcia dekóduje obsah importného súboru a pomocou call-back procedúr vytvára zodpovedajúce grafické objekty v aktívnej schéme. Vyniknuté objekty budú automaticky zapuzdrené do skupiny objektov. Výsledok importu ohlási v parametri resStr, ktorý sa zobrazí v dialógovom okne.
Tvar funkcie vo formátoch prekladačov "ADA" a "C":
procedure ImportFile(FileName:address;x,y:INTEGER;resStr:address);
void _stdcall ImportFile(char far * FileName,int x,int y,char far * resStr)
Parameter | Popis parametra |
---|---|
FileName | Vstupný parameter - meno importného súboru. |
x | Vstupný parameter - x rozmer cieľového priestoru. |
y | Vstupný parameter - y rozmer cieľového priestoru. |
resStr | Vstupný parameter - pointer na text ukončený nulou, kam import zapíše výsledok importu. Môže obsahovať maximálne 10000 znakov. |