Manual:Creating interface tools/ro

În ultimele două capitole, am văzut cum să create Part geometry și create parametric objects. O ultimă piesă lipsește pentru a obține un control deplin peste FreeCAD: Creați instrumente care vor interacționa cu utilizatorul.

În multe situații, nu este foarte ușor să construim un obiect cu valori zero, așa cum am făcut-o cu dreptunghiul din capitolul precedent, și apoi să cerem utilizatorului să completeze valorile Înălțime și Lățime din panoul Proprietăți. Aceasta funcționează pentru un număr foarte mic de obiecte, dar va deveni foarte obositoare dacă aveți multe dreptunghiuri. O modalitate mai bună ar fi să puteți da deja înălțimea și lățimea la crearea dreptunghiului.

Python oferă un instrument de bază pentru ca utilizatorul să introducă text pe ecran:

text = raw_input("Height of the rectangle?") print("The entered height is ",text)

Cu toate acestea, aceasta necesită o consolă Python care rulează, iar atunci când executăm codul dintr-o macrocomandă, nu suntem întotdeauna siguri că avem Consola Python va fi activată pe mașina utilizatorului.

Interfața utilizatorului grafic Graphical User Interface, sau GUI, adică întreaga parte a programului FreeCAD care este afișat pe ecran (meniul, barele de instrumente, vizualizarea 3D etc.), este acolo în acest scop: interacționați cu utilizatorul. Interfața FreeCAD este construită cu Qt, o trusă de instrumente GUI foarte variate, care oferă o gamă largă de instrumente, cum ar fi casete, butoane, etichete, casete de introducere a textului sau meniuri derulante. Acestea sunt numite generic "widget-uri".

Instrumentele Qt sunt foarte ușor de utilizat din Python, datorită unui modul Python numit Pyside Pyside (Există și alte module Python care comunică cu Qt de la Python). Acest modul vă permite să creați și să interacționați cu widget-uri, să citiți ce a făcut utilizatorul cu ele sau să faceți lucruri atunci când, de exemplu, a fost apăsat un buton.

Qt furnizează de asemenea un alt instrument numit Qt Designer, care astăzi este încorporată într-o aplicație mai mare numită Qt Creator Qt Creator.Permite crearea grafică a casetelor de dialog și a panourilor de interfață, în loc să le codeze manual. In acest capitol,vom folosi Qt Creator pentru a proiecta un widget pe care îl vom folosi în panoul de Sarcini Task al FreeCAD. Prin urmare, va trebui să descărcați și să instalați Qt Creator de pe official page dacă sunteți pe Windows sau Mac (sub Linux, va fi de obicei disponibilă din aplicația dvs. de manager de software).

În exercițiul următor, vom crea mai întâi un panou cu Qt Creator care solicită valorile de lungime, lățime și înălțime, apoi vom crea în jurul lui o clasă Python care va citi valorile introduse de utilizator din panou și va crea o casetă cu dimensiunile date. Acest Python va fi folosit de FreeCAD pentru afișarea și controlul panoului de sarcini:



Să începem prin crearea unui widget. Start Qt Creator, apoi meniul File -> New File or Project -> Files and Classes -> Qt -> Qt Designer Form -> Dialog without buttons. Click Next, dați-i un nume de fișier pentru a-l salva, click Next, lăsați toate câmpurile de proiect la valoarea lor implicită (" "), și Create. Sistemul de sarcini FreeCAD va adăuga automat butoanele OK / Anulare, așa că am ales aici o casetă de dialog fără butoane.




 * Găsiți Label din lista din panoul din stânga și glisați-o pe panza widget-ului nostru. Faceți dublu clic pe eticheta locației recente și modificați textul sau la Lungime.
 * Faceți clic dreapta pe pânza widget și alegeți Lay out-> Lay out in a Grid. Acest lucru va pune widgetul nostru într-o rețea cu o singură celulă, ocupată de prima noastră etichetă. Acum putem adăuga următoarele elemente la stânga, la dreapta, în partea de sus sau în partea de jos a primei noastre etichete, iar grilă se va extinde automat.
 * Adăugați încă două etichete la prima și schimbați textul la Lățime și înălțime:




 * Acum plasați 3 Double Spin Box widgets lângă etichetele Lungime, Lățime și Înălțime. Pentru fiecare dintre ele, în panoul din stânga jos, care arată toate setările disponibile pentru widgetul selectat, localizați Suffix și definiți sufixul în mm. FreeCAD are un widget mai avansat, care poate gestiona unități diferite, dar acest lucru nu este disponibil în mod implicit în Creator Qt (dar poate fi compilat compiled), așa că vom folosi o Double Spin Box standard și vom adăuga sufixul "mm" pentru a ne asigura că utilizatorul știe în ce unități lucrează:




 * Acum widget-ul nostru s-a terminat, trebuie doar să ne asigurăm de ultimul lucru. Din moment ce FreeCAD va trebui să acceseze acel widget și să citească valorile Lungime, Lățime și Înălțime, trebuie să le dăm nume potrivite widget-urilor, astfel încât să le putem recupera cu ușurință din interiorul FreeCAD. Faceți clic pe fiecare dintre Double Spin Boxes și în fereastra din partea dreaptă sus, faceți dublu clic pe Objedt Name și schimbați-le la ceva ușor de memorat, de exemplu: BoxLength, BoxWidth și BoxHeight:




 * Salvează fișierul, puteți închide cum Qt Creator, restul va fi făcut în Python.
 * Deschideți FreeCAD și creați un nou macro din meniul Macro -> Macros -> Create
 * Lipiți următorul cod. Asigurați-vă că schimbați calea fișierului pentru a se potrivi de unde ați salvat fișierul .ui creat în QtCreator:

import FreeCAD,FreeCADGui,Part path_to_ui = "C:\Users\yorik\Documents\dialog.ui" class BoxTaskPanel: def __init__(self): # this will create a Qt widget from our ui file self.form = FreeCADGui.PySideUic.loadUi(path_to_ui) def accept(self): length = self.form.BoxLength.value width = self.form.BoxWidth.value height = self.form.BoxHeight.value if (length == 0) or (width == 0) or (height == 0): print("Error! None of the values can be 0!") # we bail out without doing anything return box = Part.makeBox(length,width,height) Part.show(box) FreeCADGui.Control.closeDialog panel = BoxTaskPanel FreeCADGui.Control.showDialog(panel)
 * 1) CHANGE THE LINE BELOW

În codul de mai sus, am folosit o funcție convenabilă (PySideUic.loadUi) din modulul FreeCADGui. Această funcție încarcă un fișier .ui, creează un widget Qt din acesta și scrie numele, astfel încât să putem accesa cu ușurință subspațiul după nume (ex: self.form.BoxLength).

Funcția "accept" este, de asemenea, o comoditate oferită de Qt. Atunci când există un buton "OK" într-o casetă de dialog (care este cazul în mod implicit când se utilizează panoul Task FreeCAD) "accept" va fi executat automat când apăsați butonul "OK". În mod similar, puteți adăuga o funcție de "respingere" care se execută atunci când apăsați butonul "Cancel". În cazul nostru, am eliminat această funcție, așa că apăsând "Cancel" va cauza comportamentul implicit (nu faceți nimic și închideți caseta de dialog).

Dacă implementăm oricare dintre funcțiile de acceptare sau de respingere, comportamentul implicit (nu face nimic și închide) nu va mai avea loc. Așa că trebuie noi înșine trebuie să închidem panoul de sarcini. Acest lucru se face cu:

FreeCADGui.Control.closeDialog

Once we have our BoxTaskPanel that has 1- a widget called "self.form" and 2- if needed, accept and reject functions, we can open the task panel with it, which is done with these two last lines:

panel = BoxTaskPanel FreeCADGui.Control.showDialog(panel)

Note that the widget created by PySideUic.loadUi is not specific to FreeCAD, it is a standard Qt widget which can be used with other Qt tools. For example, we could have shown a separate dialog box with it. Try this in the Python Console of FreeCAD (using the correct path to your .ui file of course):

from PySide import QtGui w = FreeCADGui.PySideUic.loadUi("C:\Users\yorik\Documents\dialog.ui") w.show

Bineînțeles noi nu am adăugat butonul "OK" sau "Cancel" în caseta nostră de dialog, deoarece a fost făcut pentru a fi utilizat de panoul sarcini(Task) FreeCAD, care oferă deja astfel de butoane. Deci, nu există nicio modalitate de a închide dialogul(altul decât apăsarea butonului de închidere a ferestrei). Dar funcția show creează o casetă de dialog nemodal, ceea ce înseamnă că aceasta nu blochează restul interfeței. Deci, în timp ce dialogul este încă deschis, putem citi valorile câmpurilor:

w.BoxHeight.value

This is very useful for testing.

În cele din urmă, nu uitați că există mult mai multe despre widgeturile QT pe FreeCAD Wiki, în secțiunea Python Scripting, care conține dialog creation tutorial, o parte terță specială  PySide tutorial care acoperă în mode extins subiectul.

De citit în plus


 * Qt Creator
 * Installing Qt Creator
 * Python scripting documentation
 * Dialog creation tutorial
 * PySide tutorials
 * PySide documentation