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" ["SaveAsPointCloud"]]]]]

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ă;
• SaveAsPointCloud - în cazul fișierelor ce vor fi salvate cu una din extensiile TXT, XYZ sau CSV puteți alege ca salvarea să fie făcută în formatul nor de puncte, valoarea poate fi "T" sau "F" însemnând True sau False.

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++.