Funkcie rozhrania pre import vektorových formátov do schém

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:

  1. Identifikačná funkcia - dodáva popis importného formátu a typ prípony importného súboru
  2. Inicializačná funkcia - inicializuje call-back funkcie, zabezpečujúce spätné volania funkcii procesu D2000 GrEditor
  3. Výkonná funkcia - zabezpečuje import súboru do zadaných rozmerov schémy

Identifikačná funkcia


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.

Inicializačná funkcia


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


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.
Napíšte komentár