Programul TransLT.exe poate fi folosit şi prin apelare externă din linia de comandă sau prin apelarea lui de un alt program. Atunci când este apelat în acest mod TransLT realizează conversia unui fişier de coordonate conform unui model de transformare preluat din fişier sau desenează entităţi grafice în Google Earth.

Setările programului privind unităţile de măsură şi opţiunile generale sunt folosite la această conversie şi pot fi schimbate din programul principal apelând butonul Opţiuni.

Utilizarea din linia de comandă

1. Conversia unui fişier de coordonate

TransLT.exe "/F" "ModelFile" "ModelIndex" "UseReversed" "InputFile" "OutputFile" ["ShowError" ["AppHwnd" ["EpochT" ["EpochT0"]]]]

unde:
• /F - indică opţiunea de conversie a unui fişier de coordonate;
• ModelFile - numele fişierului cu modelul de transformare, fişier cu extensia mtr sau mtrs;
• ModelIndex - selectaţi numărul modelului. Pentru fişiere mtr indexul este întotdeauna 1 iar pentru fişierele mtrs cu modele multiple indexul este de la 1 în sus;
• UseReversed - selectaţi dacă modelul de transformare este utilizat sau nu inversat, valoarea poate fi "T" sau "F" însemnând True sau False;
• InputFile - numele fişierului de coordonate cu datele de intrare;
• OutputFile - numele fişierului în care vor fi salvate coordonatele calculate;
• ShowError - parametru ce indică dacă sunt afişate sau nu erorile posibile si poate fi "T" sau "F" adică True sau False;
• AppHwnd - handle-ul ferestrei ce va recepţiona mesajele referitoare la erori, progresul execuţiei în procente şi mesajul de terminare a execuţiei;
• EpochT - an cu zecimale folosit doar pentru transformările dependente de timp, dacă valoarea lipseşte se ia in calcul data curentă.
• EpochT0 - an cu zecimale folosit doar pentru griduri de viteză (mişcarea punctelor) pentru calcularea T - T0, dacă valoarea lipseşte se ia in calcul data curentă.

Parametrii trecuţi între parantezele [ ] sunt opţionali iar aceste paranteze nu trebuiesc trecute în linia de comandă.

Fişierul de ieşire trebuie să fie diferit de fişierul de intrare, programul nu salvează datele peste fişierul de intrare deoarece datele de intrare se vor pierde.

2. Conversia unui fişier de coordonate cu entităţi şi desenarea directă în Google Earth sau salvarea fişierului în format csv, xml, kml sau kmz

TransLT.exe "/D" "ModelFile" "ModelIndex" "InputFile" ["EditEnts" ["OutputFile" ["DelInpFile" ["EpochT" ["EpochT0"]]]]]

unde:
• /D - indică opţiunea de conversie a unui fişier cu entităţi şi de desenare în Google Earth sau de salvare în format csv, xml, kml sau kmz;
• ModelFile - numele fişierului cu modelul de transformare, fişier cu extensia mtr sau mtrs;
• ModelIndex - selectaţi numărul modelului. Pentru fişiere mtr indexul este întotdeauna 1 iar pentru fişierele mtrs cu modele multiple indexul este de la 1 în sus;
• InputFile - numele fişierului de coordonate cu datele de intrare, fişier cu entităţi definite cu coordonate N, E doar în această ordine;
• EditEnts - selectaţi dacă fişierul cu entităţi rezultat este editat sau nu, parametrul poate fi "T" sau "F" însemnând True sau False. În cazul "T" fereastra TransLT de desenare în Google Earth este deschisă;
• OutputFile - numele fişierului în care vor fi salvate coordonatele calculate, acesta poate fi csv sau xml (pentru TransLT), kml sau kmz (pentru Google Earth);
• DelInpFile - selectaţi dacă fişierul de intrare este şters sau nu, parametrul poate fi "T" sau "F" însemnând True sau False;
• EpochT - an cu zecimale folosit doar pentru transformările dependente de timp, dacă valoarea lipseşte se ia in calcul data curentă.
• EpochT0 - an cu zecimale folosit doar pentru griduri de viteză (mişcarea punctelor) pentru calcularea T - T0, dacă valoarea lipseşte se ia in calcul data curentă.

Parametrii trecuţi între parantezele [ ] sunt opţionali iar aceste paranteze nu trebuiesc trecute în linia de comandă.

Dacă parametrul cu numele fişierul de ieşire OutputFile este un şir gol şi dacă EditEnts este False  sau dacă ambele sunt omise atunci entităţile din fişier sunt desenate direct în Google Earth.

3. Deschide fereastra TransLT de conversie a coordonatelor dintr-un fişier şi apoi deschide fereastra TransLT de desenare entităţi în Google Earth

TransLT.exe "/CG" ["InputFile"]

unde:
• /CG - indică opţiunea de conversie a unui fişier şi apoi de desenare în Google Earth folosind ferestrele TransLT;
• InputFile - numele fişierului de coordonate cu datele de intrare, fişier cu entităţi definite cu coordonate N, E doar în această ordine.

4. Opţiuni comune de utilizare a TransLT în Windows

TransLT.exe "/M" "ModelFile"

unde:
• /M - indică opţiunea de deschidere a unui fişier cu un model sau cu mai multe modele pentru a fi adăugate la lista de modele din programul principal;
• ModelFile - numele fişierului cu modelul de transformare, fişier cu extensia mtr sau mtrs.

 

TransLT.exe "/P"

unde:
• /P - indică opţiunea de deschidere a ferestrei TransLT de desenare a unui poligon în Google Earth.

 

TransLT.exe "/G" ["InputFile"]

unde:
• /G - indică opţiunea de deschidere a ferestrei TransLT de desenare a entităţilor în Google Earth;
• InputFile - numele fişierului cu datele de intrare, fişier cu entităţi definite în coordonate geografice cu formatul csv sau xml.

 

TransLT.exe "/C"

unde:
• /C - indică opţiunea de deschidere a ferestrei TransLT de conversie fişiere cu coordonate.

 

TransLT.exe ["InputFile"]

Deschide fereastra TransLT de conversie fişiere şi adaugă fişier.

unde:
• InputFile - numele fişierului de coordonate cu datele de intrare.

 

TransLT.exe "?" sau "/?" sau "/H"

Afişează ajutorul în linia de comandă, afişarea este făcută doar în limba engleză.

 

Exemple de utilizare

Exemplu de utilizare din linia de comandă sau de utilizare într-un fişier script .bat:

TransLT.exe "/F" "C:\My model.mtr" "1" "T" "C:\My file.coo" "C:\My file.csv" "T"

Exemplu de apelare dintr-un alt program (sintaxă pascal în Delphi):

var ParamStr: string; begin ParamStr:= '"/F" '+ //Parameter coomand for external use of TransLT ("/F" = convert coordinates file) '"'+ModelFile+'" '+ //Transformation model file '"1" '+ //Model index '"F" '+ //Use reversed transformation F = False, T = True '"'+InputFile+'" '+ //Coordinate input file '"'+OtputFile+'" '+ //Coordinate output file '"F" '+ //Show message error F = False, T = True '"'+IntToStr(Self.Handle)+'" '+ //Handle of receiver application (This form) '"2014.64" ' + //EpochT value '"2010.00"'; //EpochT0 value ShellExecuteW(Self.Handle, 'open', PWideChar(WideString('TransLT.exe')), PWideChar(ParamStr), nil, SW_SHOWNORMAL); end;

unde variabila Self.Handle reprezintă handle-ul ferestrei care a lansat în execuţie TransLT.

Exemplu de apelare dintr-un alt program (sintaxă c++ în VS 2010):

String ^ParamStr = gcnew String(""); ParamStr += "\"/F\" "; //Parameter coomand for external use of TransLT ("/F" = convert coordinates file) ParamStr += "\""+ModelFile+"\" "; //Transformation model file ParamStr += "\"1\" "; //Model index ParamStr += "\"F\" "; //Use reversed transformation F = False, T = True ParamStr += "\""+InputFile+"\" "; //Coordinate input file ParamStr += "\""+OtputFile+"\" "; //Coordinate output file ParamStr += "\"F\" "; //Show message error F = False, T = True ParamStr += "\""+Convert::ToString(this->Handle.ToInt32())+"\" "; //Handle of receiver application (This form) ParamStr += "\"2014.64\" "; //EpochT value ParamStr += "\"2010.00\""; //EpochT0 value ShellExecuteW(HWND(this->Handle.ToInt32()), L"open", L"TransLT.exe", GetLPSTR(ParamStr), NULL, SW_SHOWNORMAL);

unde variabila this->Handle reprezintă handle-ul ferestrei care a lansat în execuţie TransLT.

 

În acest caz fereastra care a lansat în execuţie TransLT va primi mesaje referitoare la:
• progresul execuţiei în procente de la 0 până la 100;
• mesajele de eroare;
• mesajul de terminare a execuţiei.

Descrierea mesajelor transmise de TransLT

Mesajele sunt transmise cu funcţia SendMessage cu identificatorul de mesaj WM_COPYDATA:

SendMessage(AppHwnd, WM_COPYDATA, 0, LParam(@cds));

unde variabila cds este de tipul TCopyDataStruct în pascal sau COPYDATASTRUCT în c++.

Valorile transmise prin variabila cds pot fi, în funcţie de mesaj, următoarele:
1. Pentru mesajele privind progresul execuţiei:
   • cds.cbData = număr caractere conţinute în cds.lpData;
   • cds.lpData = 'PROG_BAR_POS' text de identificare;
   • cds.dwData = procentul cu valori între 0 şi 100.
2. Pentru mesajele de eroare:
   • cds.cbData = număr caractere conţinute în cds.lpData;
   • cds.lpData = text cu mesajul de eroare conform limbii setate în TransLT;
   • cds.dwData = numărul erorii cu valoare mai mare decât 0.
3. Pentru mesajul final de terminare a execuţiei:
   • cds.cbData = număr caractere conţinute în cds.lpData;
   • cds.lpData = 'CONV_DONE' text de identificare;
   • cds.dwData = 0.

Procedura prin care pot fi interpretate mesajele atunci când sunt recepţionate (sintaxă pascal în Delphi):

type TForm1 = class(TForm) ... private { Private declarations } procedure WMCopyData(var Msg : TWMCopyData); message WM_COPYDATA; public { Public declarations } end; ... procedure TForm1.WMCopyData(var Msg: TWMCopyData); var MsgTxt: string; ErrNo: integer; begin SetString(MsgTxt, PChar(Msg.CopyDataStruct.lpData), Msg.CopyDataStruct.cbData); MsgTxt:= WideCharToString(PChar(MsgTxt)); if MsgTxt = 'PROG_BAR_POS' then begin //Receives progress bar position value ProgressBar1.Position:= Msg.CopyDataStruct.dwData; end else if Msg.CopyDataStruct.dwData <> 0 then begin //Receives TransLT error ErrNo := Msg.CopyDataStruct.dwData; MessageBoxW(Self.Handle, PChar('ERROR (' + IntToStr(ErrNo) + '): ' + MsgTxt), 'Error', MB_OK); ProgressBar1.Position:= 0; end else if MsgTxt = 'CONV_DONE' then begin //Receives TransLT end message ShowMessage('TransLT conversion done.'); ProgressBar1.Position:= 0; end; end; ...

Funcţia prin care pot fi interpretate mesajele atunci când sunt recepţionate (sintaxă c++ în VS 2010):

... protected: [SecurityPermission(SecurityAction::Demand, Flags=SecurityPermissionFlag::UnmanagedCode)] virtual void WndProc( Message% m ) override { // Listen for operating system messages. switch ( m.Msg ) { case WM_COPYDATA: COPYDATASTRUCT *cds = PCOPYDATASTRUCT(m.LParam.ToInt32()); wchar_t Stxt[1024] = L""; memcpy(Stxt, cds->lpData, cds->cbData); if (wcscmp(Stxt, L"PROG_BAR_POS") == 0) { progressBar1->Value = (int)cds->dwData; } else if (cds->dwData != 0) { //Receives TransLT error //int ErrNo = cds->dwData; String ^TxtErr = gcnew String(Stxt); MessageBox::Show(this, TxtErr, L"Error", MessageBoxButtons::OK); delete TxtErr; progressBar1->Value = 0; } else if (wcscmp(Stxt, L"CONV_DONE") == 0) { //Receives TransLT end message MessageBox::Show(this, L"TransLT conversion done.", L"This Test", MessageBoxButtons::OK); progressBar1->Value = 0; } break; } Form::WndProc( m ); } ...

Pentru implementarea în aplicaţiile dumneavoastră puteţi descărca aplicaţiile de test realizate în Delphi şi în Visual C++.