Generarea macrourilor în MicroStation '95

DE Dorian NEDELCU, Aurelian HĂU şi Ovidiu TUDORA

Prezentul articol îşi propune să prezinte detaliat modul de generare al unui macro care calculează desfăşurata trunchiului de con, utilizând limbajul BASIC încorporat programului de proiectare asistată MicroStation '95.

Generalităţi

Prin intermediul unui exemplu simplu de macro ce tratează problema desfăşurării unui trunchi de con (figura 1) , cititorii vor putea înţelege modul de generare a unui macro în MicroStation '95, atât prin prezentarea sursei cât şi prin parcurgerea etapelor necesare construirii acestuia, asociate cu explicaţii detaliate.

Licenţa MicroStation '95 este însoţită de manualul MicroStation BASIC Guide, care cuprinde descrierea comenzilor limbajului MicroStation BASIC. Acelaşi manual este livrat şi pe CD-ul de instalare a MicroStation '95, în format PDF.

Crearea unui macro (New), editarea sursei (Edit), rularea acestuia (Run), o scurtă descriere a macro-ului (Detail - ce afişează primele linii de comentarii din sursa macro-ului) respectiv localizarea macroului (Browse) sunt disponibile din fereastra MACROS apelabilă din meniul principal MicroStation '95, în succesiunea Utilities ( Macros (figura 2). Forma sursă a unui macro este un fişier cu extensia "bas", iar versiunea compilată un fişier cu extensia "ba".

Există câteva posibilităţi prin care un macro poate interacţiona cu utilizatorul în timpul execuţiei (selectarea unui obiect, introducerea unui punct cu mouse-ul sau de la tastatură). Pe lângă acestea utilizatorul poate opera cu ferestre de dialog standard pentru deschiderea unui fişier (MbeFileOpen), crearea unui fişier (MbeFileCreate), afişarea unui mesaj cu posibilităţi de răspuns predefinite (MbeMessageBox), introducerea unei valori (MbeInputBox), selecţia unei opţiuni dintr-o listă (MbeSelectBox), sau cu ferestre de dialog definite de utilizator (forme) pentru situaţia în care datele necesare a fi introduse sunt mai complexe.

Sursa macro-ului

Sursa macro-ului este inclusă în prezentul articol, fiecare linie fiind însoţită de comentarii pentru uşurarea înţelegerii scopului instrucţiunilor. Limbajul BASIC MicroStation '95, în care este realizat acest macro, conţine instrucţiuni clasice corespunzătoare BASIC-ului, precum şi instrucţiuni specializate de interacţiune cu nucleul grafic MicroStation '95, a căror sintaxă conţine prefixul Mbe.

Scrierea unei noi surse de macro, sau editarea uneia existente se realizează prin BASIC Editor (figura 3), apelabil din fereastra MACROS prin opţiunile New respectiv Edit. BASIC Editor are un meniu propriu cu următoarele bare de meniu:

• File cu opţiunile corespunzătoare de lucru cu fişiere (New, Open, Save, Save As, Exit)
• Edit cu opţiuni pentru operaţii de editare (Undo, Redo, Find, Find Next, Cut, Copy, Paste), pentru activarea ferestrei Variables ce permite vizualizarea şi modificarea variabilelor macro-ului în timpul rulării debugger-ului, pentru activarea opţiunii Custom Dialog în vederea editării formelor (opţiunea Edit) respectiv inserarea în macro-ul curent la poziţia cursorului a liniei sursă de apel a formei selectate (opţiunea Insert):

ActionButton = MbeOpenModalDialog <(număr identificare formă selectată)>

Valoarea returnată de ActionButton este determinată de butonul selectat pentru închiderea formei (ex. valoarea 4 la selectarea butonului CANCEL în macro-ul exemplu).

• Run cu opţiuni pentru execuţia (Execute) sau oprirea (Break) macro-ului respectiv operaţii specifice debugger-ului: Step Into care permite rularea macro-ului linie cu linie şi afişarea tuturor liniilor executate, Step Over care permite rularea şi afişarea liniilor macro-ului, exceptând cele din subrutine, care sunt rulate fără a fi afişate, Go care permite continuarea execuţiei unui macro de la linia curentă spre sfârşit sau până la întâlnirea unui breakpoint, Stop Debug care întrerupe sesiunea curentă de depanare a programului.

Macro-ul exemplu este compus din rutina principală (Sub Main) şi o subrutină (Trasare_arc), care realizează trasarea unui arc prin trei puncte (punct start, centru arc, punct final). Comunicarea între rutina apelantă şi cea apelată se face prin mecanismul transmiterii parametrilor actuali către parametrii formali. Introducerea datelor iniţiale pentru calculul desfăşuratei se realizează prin forma din (figura 4).

Codul sursei nu conţine instrucţiuni de generare a formei, ci numai apelarea ei, modul de generare al formei fiind prezentat în secţiunea următoare. În macro trebuie declarate ca publice toate variabilele asociate obiectelor formei de introducere a datelor iniţiale (căsuţe text, butoane, liste, etc.).

Variabilele programului trebuie să fie declarate ca tip (integer, long integer, string, single, double precision, MbePoint), ceea ce poate fi realizat în două moduri:

• explicit, prin dimensionare (instrucţiunea DIM ) la început de macro sau procedură
• implicit, când variabila este utilizată prima oară, prin adăugarea unui caracter specific la sfârşitul numelui variabilei (exemplu % pentru tip integer, # pentru tip double precision, $ pentru tip string, etc.).

Macro-ul parcurge următoarele etape:

• salvare configuraţie MicroStation '95 existentă înainte de rularea macro-ului
• activare formă de introducere date iniţiale şi verificarea corectitudinii acestora
• configurarea MicroStation '95 conform setărilor din formă
• calculul matematic al desfăşuratei trunchiului de con, algoritmul de calcul fiind simplu, neprezentând interes pentru scopul articolului de faţă
• activare fereastră de desenare desfăşurată
• desenare desfăşurată
• setare variabile de cotare şi cotare desfăşurată
• setare variabile corespunzătoare textului şi scriere text
• restaurare configuraţie MicroStation '95 existentă înainte de rulare macro.

Crearea formei macro-ului

Generarea formei de date iniţiale a macro-ului se realizează nu prin cod, ci similar cu modul de generare a formelor propriu programului Visual Basic. Într-un macro pot fi definite una sau mai multe forme, apelabile succesiv. Acestea sunt întotdeauna de tip modal, adică execuţia macro-ului este suspendată până la închiderea formei, controlul fiind returnat macro-ului; acest fapt implică existenţa a cel puţin unui Push Button pentru închidere a formei (OK sau Cancel).

Etapele generării unei forme sunt:

1. Apelare Builder (figura 5) din meniul BASIC Editor în următoarea succesiune: Edit ( Custom Dialog ( Edit. Simultan cu apariţia Builder-ului se deschide şi bara Tools (figura 6) ce conţine obiectele generice ce pot fi plasate inserate pe formă (Text, Label, Toggle Button, Group Box, Option Button, Push Button, Color Picker, Level Map, Scale, Radio Button).
2. Crearea unei forme prin intermediul butonului New sau încărcarea uneia existente prin butonul Load. Butoanele au corespondent pe opţiunile New respectiv Load din meniul Dialog al Builder-ului. În urma acestor acţiuni, în cazul creării unei noi forme va apare forma care conţine iniţial butoanele OK şi Cancel, iar în cazul încărcării uneia existente va apare Load Dialog, care va permite selecţia formei care se doreşte a se edita. Sunt posibile şi deschiderea unei forme existente numai pentru citire (Read Only) şi/sau ca o copie a originalului în vederea salvării sub un alt nume pentru modificări ulterioare, prin specificarea acestor opţiuni din Load Dialog.
3. Caracteristicile formei (titlu, număr de identificare, lăţime şi înălţime) pot fi specificate prin fereastra Dialog Box Attributes (figura 7) apelabilă prin succesiunea de opţiuni Options ( Dialog Attributes? din meniul Builder-ului. În timpul editării formei, în bara de titlu a ferestrei Builder este specificat numele şi calea fişierului compilat în care se va salva forma.
4. Plasarea obiectelor se realizează prin selectare din bara Tools şi poziţionare lor pe formă. Obiectele pot fi mutate pe formă, redimensionate similar obiectelor Windows. Fiecare obiect plasat pe formă este introdus automat şi în lista Builder-ului ce conţine coordonatele de poziţie, dimensiunile şi caracteristicile de identificare ale obiectului. Selecţia unui obiect se realizează prin click pe obiect, ceea ce are ca efect apariţia marker-ilor obiectului. Selecţia mai multor obiecte se realizează prin click succesiv pe obiecte cu tasta SHIFT apăsată. Alinierea obiectelor selectate (Left, Right, Top, Bottom , Center, etc.) se poate realiza selectând opţiunea corespunzătoare din bara de meniu Alignment a meniului Builder-ului. Ştergerea unuia sau mai multor obiecte se poate realiza, după operaţia de selecţie, prin activarea ferestrei Builder-ului (prin click pe fereastra Builder-ului) şi apăsarea tastei Del, urmată de confirmarea operaţiei de ştergere. Sunt posibile operaţii de Cut, Copy, Paste a obiectelor, după operaţia de selecţie, prin selecţia opţiunii corespunzătoare din bara de meniu Edit a ferestrei Builder-ului, după activarea acesteia prin click.

Un obiect nu conţine un cod de program asociat ci numai câteva caracteristici predefinite. Specificarea caracteristicilor fiecărui obiect se realizează într-o fereastră care poate fi activată prin dublu-click pe obiect. Cea mai importantă caracteristică a obiectului este Access String, prin care valoarea primită de obiect in timpul execuţiei este transmisă variabilei publice corespondente declarate în macro. Tabelul următor prezintă corelaţia impusă între tipul obiectului de pe formă şi tipul variabilei declarată ca publică:

Alte caracteristici ale obiectelor ce pot fi plasate pe formă sunt:

• Label - conţine eticheta obiectului;
• # of Chars - numărul maxim de caractere ce pot fi introduse în câmp in timpul execuţiei;
• Read Only - împiedică editarea valorii afişate;
• Label Above - dispunerea etichetei deasupra obiectului.

Explicaţii referitoare la toate caracteristicile obiectelor nu pot fi cuprinse în articolul de faţă, fiind descrise însă detaliat în manualul MicroStation BASIC Guide.

Figurile 8, 9, 10, 11, 12 prezintă ferestrele de specificare a caracteristicilor pentru următoarele obiecte: Text, Option, Color Picker, Push Button, Group Box, utilizate în cadrul macro-ului exemplu.

5. Testarea formei se poate realiza chiar în timpul editării, prin activarea opţiunii Test Dialog din bara de meniu Options a meniului Builder-ului. În timpul testării forma devine activă şi toate obiectele din formă pot fi testate, fără rularea efectivă a macro-ului. Ieşirea din testarea formei se realizează prin dezactivarea aceleiaşi opţiuni.

6. Salvarea formei se realizează prin activarea butonului Save a ferestrei Builder-ului, după activarea acesteia prin click, urmat de confirmarea operaţiei de salvare. O formă definită de utilizator este salvată numai în format binar în versiunea compilată a macro-ului (fişierul cu extensia "ba").

Generarea automată a unui macro

MicroStation '95 oferă o posibilitate deosebit de utilă: generarea automată a macro-urilor, adică generarea codului sursă (prin instrucţiuni specifice extensiei limbajului BASIC MicroStation) bazat pe interacţiunile succesive ale utilizatorului cu mediul MicroStation '95. Avantajele acestei metode sunt evidente: învăţarea rapidă a comenzilor limbajului Basic extins precum şi posibilitatea introducerii într-un macro propriu (prin operaţia de editare specifică Copy & Paste) a codului sursă generat în acest mod.

Generarea automată a unui macro se realizează prin parcurgerea următoarele etape:

• Deschiderea ferestrei Create Macro (figura 13) prin selecţia opţiunii Utilities ( Create Macro din meniul principal MicroStation '95
• Completarea câmpurilor ferestrei Create Macro adică nume, scurtă descriere respectiv localizarea macro-ului
• butonului OK care porneşte sesiunea de generare a macro-ului, ceea ce are ca efect startarea propriu-zisă simultan cu apariţia unei mici ferestre care controlează sesiunea de generare a macro-ului (figura 14), care conţine butoanele Play (stânga), Pause (mijloc) şi End (dreapta); titlul acestei ferestre coincide cu numele macro-ului declarat anterior
• Controlul sesiunii de generare a macro-ului, prin următoarele butoane:

Play - la activarea acestui buton acţiunile utilizatorului sunt capturate şi se scrie automat în macro codul corespunzător acţiunilor; la afişarea iniţială a ferestrei, acest buton este activ

Pause - activarea acestui buton se întrerupe scrierea automată în macro a codului corespunzător acţiunilor utilizatorului; pauza este utilă atunci când nu trebuie capturate acţiuni în timpul sesiunii de generare a macro-ului; reactivarea capturării acţiunilor se realizează prin activarea butonului Play

End - activarea acestui buton are ca efect închiderea sesiunii de generare a macro-ului; operaţia se poate realiza şi prin selecţia opţiunii End Macro din bara de meniu Utilities a meniului principal MicroStation '95.

Comenzi limbaj BASIC extins

Extensia limbajului BASIC MicroStation oferă programatorilor de macro-uri acces la resursele programului MicroStation '95. Scopul extensiei BASIC este de a simplifica interacţiunea programatorului cu MicroStation '95. Instrucţiunile extensiei BASIC se disting de cele ale limbajului BASIC clasic prin prefixul Mbe pentru funcţii, tipuri, obiecte sau colecţii predefinite, prefixul Mbe_ fiind rezervat constantelor predefinite specifice ale MicroStation '95. Extensia BASIC cuprinde instrucţiuni specifice pentru următoarele grupe de operaţii : accesul la informaţiile din şi despre fişierul desen, accesarea şi modificarea setărilor MicroStation '95, accesarea informaţiilor stării curente a MicroStation '95, manipularea ferestrelor şi a vederilor dintr-o fereastră, accesarea referinţelor, a bazelor de date. De asemenea se pot transmite comenzi de desenare, se pot simula introduceri de puncte (click stânga mouse) sau reset (click dreapta mouse).

Pentru macro-ul exemplu din prezentul articol, vor fi explicate numai instrucţiunile cu prefixul Mbe utilizate, celelalte fiind instrucţiuni clasice BASIC:

• MbeSettings.Color, MbeSettings.Weight, MbeSettings.Level permite memorarea /modificarea următoarelor setări curente de desenare: culoare, grosime de linie respectiv level;
• MbeSendCommand permite trimiterea către MicroStation '95 a unei comenzi de desenare, vizualizare, etc., a cărei sintaxă este identică cu cea introdusă direct în timpul desenării prin intermediul ferestrei Key-in, activată din opţiunea Utilities ( Key-in din meniul principal MicroStation '95; comanda trimisă este delimitată de ghilimele;
• MbeSendDataPoint transmite un punct mediului de desenare MicroStation '95 (similar cu un click cu butonul stânga mouse). Comanda are ca argumente coordonata (x,y,z) a punctului şi numărul ferestrei căreia îi este adresată comanda. În macro-ul exemplu coordonata punctului transmis este explicită, dar este des folosită şi transmiterea unei variabile declarată de tip MbePoint (ex. pentru transmiterea unui punct de coordonate 0,0,0 la fereastra 1 se pot folosi comenzile: Dim punct as MbePoint, punct.x=0, punct.y=0, punct.z=0, nr_vedere=1, MbeSendDataPoint punct,nr_vedere);
• MbeSendReset transmite un reset (similar cu un click cu butonul dreapta mouse) către MicroStation '95 pentru ieşirea dintr-o comandă, introducerea unui nou text dacă suntem în execuţia unei asemenea operaţii, etc.;
• MbeSet[?]AppVar[?] set de comenzi care stabilesc variabilele necesare operaţiilor de cotare (dimensiuni text cote, tip săgeată, aliniere cote, etc.)
• MbeMessageBox transmite un mesaj către utilizator. Implicit căsuţa de dialog în care apare mesajul conţine doar butonul OK . Instrucţiunea poate fi folosită ca în macro-ul exemplu, caz în care apare doar butonul OK sau folosind sintaxa: buton=MbeMessageBox(mesaj as string [,tip_dialog as long]). Mesajul este delimitat de ghilimele, iar tip_dialog poate lua valorile: 1 caz în care apare numai butonul OK, 3 când apare OK şi CANCEL, 12 când apare YES şi NO, 14 când apare YES, NO şi CANCEL. Suplimentar pe căsuţa de dialog se poate afişa şi o iconiţă fiind necesară, în acest caz, una din constantele: 256 pentru iconiţa de STOP, 512 pentru SEMN DE ÎNTREBARE, 1024 pentru iconiţa de informaţii, 2048 pentru SEMN DE EXCLAMAŢIE (ex. buton=MbeMessage Box("TEST" ,3+256) determină apariţia unei căsuţe de dialog ce afişează mesajul TEST, are butoane de OK şi CANCEL şi conţine iconiţa de STOP). În variabila buton este memorată valoarea butonului selectat pentru închiderea căsuţei; pentru a afla valoarea întoarsă de variabila buton se poate folosi instrucţiunea MbeMessageBox(str$(buton)).

Crearea unei icoane ataşate unui macro

Pe lângă posibilitatea de a rula un macro prezentată în primul capitol al articolului, utilizatorul poate crea propria opţiune de meniu sau propria icoană, la selectarea căreia MicroStation '95 să execute o comandă sau un macro. Icoana se poate insera într-o bară de icoane existentă sau se poate defini o nouă bară de icoane (Tool Frames).

Pentru definirea unei noi icoane se apelează din meniul MicroStation '95 succesiunea de opţiuni Workspace ( Customize şi din fereastra Customize (figura 15), se alege opţiunea Tool Frames (din partea stânga sus), iar din partea dreaptă Create Tool Frame..., după care se deschide o fereastră unde se specifică titlul noii bare şi se selectează butonul Insert pentru a insera o nouă icoană. După selectarea acestui buton se deschide editorul de icoane (figura 16), unde se desenează icoana, se specifică (în căsuţa Tool Tips) mesajul ce va fi afişat de MicroStation '95 la mişcarea mose-ului în zona icoanei, iar în câmpul Key-in se tastează comanda ce va fi executată la apăsarea icoanei (în cazul nostru rularea unui macro ce l-am denumit "desf_con": macro desf_con). Salvarea noii bare ce conţine icoana nou definită se face prin selectarea butonului Save din fereastra Customize.

Urmărind paşii descrişi în articol, cititorii îşi pot crea macro-uri utile, pot defini icoane pentru apelarea lor sau pentru apelarea unor comenzi ce nu sunt cuprinse în barele cu icoane predefinite ale MicroStation '95, putând astfel să-şi simplifice munca şi să-şi creeze o interfaţă de lucru după propriile necesităţi.

Cititorii interesaţi pentru relaţii suplimentare sau soluţii pot apela autorii la tel. 055-431715 int. 195 sau mobil 092-718560, în cadrul Centrului de Cercetare-Dezvoltare pentru Echipamente Hidroenergetice al U.C.M.Reşiţa S.A

(C) Copyright Computer Press Agora