Donate

Въведение

Конзолата за Python е панел част от потребителския интерфейс на FreeCAD. Той управлява интерпретатор на Python, който може да се използва за управляване на процеси във FreeCAD и създаване, и модифициране на обекти и техните свойства.

Тя може да бъде направена видима/скрита чрез падащото меню View → Panels → Python Console.

Конзолата за Python във FreeCAD има основно оцветяване на синтаксиса, за да се обозначават с различни стилове и цветове, коментари, низове, цифрови стойности, вградени функции, печатен текстов изход и разделители като скоби и запетаи. Тези свойства на конзолата могат да бъдат конфигурирани в Preferences Editor.

Конзолата за Python, показваща съобщения, когато FreeCAD току що е стартиран.

Скриптове

За напълно начинаещи, вижте: Introduction to Python, и Python scripting tutorial.

Вижте също: FreeCAD scripting basics, и Scripted objects.

Конзолата за Python може да извършва основно завършване на код, когато точка е написана след обект; тя ще покаже публичните методи и атрибути (променливи) на текущия обект (клас), например, obj.

Конзолата също така е в състояние да покаже низ - документация на определена функция, когато бъде написана отваряща скоба, например function(

Пример: Код на Python, който създава обекти в 3D изгледа.

Скриптовете за инициализация на FreeCAD автоматично зареждат някои модули и определят някои псевдоними. Ето защо, в конзолата за Python те са налични:

App = FreeCAD
Gui = FreeCADGui

Следователно това е равносилно на:

App.newDocument()
FreeCAD.newDocument()

Breote: тези предварително заредени модули и псевдоними са достъпни само от конзолата за Python, вградена в програмата FreeCAD. Ако използвате FreeCAD като библиотека във външна програма, трябва помните да заредите модулите FreeCAD и FreeCADGui и да определите необходимите псевдоними, ако желаете.

Контекстно меню

Когато щракнете с десния бутон върху конзолата за Python се отваря контекстно меню със следните команди:

• Copy или Копиране: съхранява избрания текст в клипборда за по-късно поставяне; командата е деактивирана, ако не е избрано нищо.
• Copy Command или Копиране на команда: съхранява избраната команда в клипборда за по-късно поставяне; командата е деактивирана, ако не е избрано нищо.
• Copy History или Копиране на историята: копира цялата история от Python команди, въведени в тази сесия.
• Save History As... или Запис на историята като...: записва цялата история на командите на Python, въведени в тази сесия, в текстов файл.
• Отметка Save History или Save History: предстои да се опише.
• Paste или Поставяне: поставя предварително копиран текст в клипборда към конзолата за Python.
• Select All или Избиране на всичко: избира всички текстове в конзолата за Python.
• Clear Console или Изчистване на конзолата: изтрива всички команди, въведени в конзолата за Python. Това е полезно, ако конзолата за Python е пълна със съобщения и преди това въведени команди, които може да разсейват при тестване на нова функция. Това е просто естетично, тъй като тази команда не изтрива съществуващите променливи, нито изчиства импортираните модули в сесията.
• Insert File Name... или Вмъкнете име на файл...: отваря диалогов прозорец за търсене на файл в системата, след което вмъква пълния път на файла. Това е полезно да се тестват функции, които обработват входен файл, без да се налага да се пише цялото име в конзолата, което е предразположено към грешки. Тази команда не изпълнява файла и не го импортира като модул на Python, той просто връща пълния път на този файл.
• Отметка Word Wrap или Думи в сбит вид: пренася много дълги редове, които надвишават хоризонталната ширина на конзолата за Python.

Бележки

• Потребителят има възможност да преглежда API в конзолата на Python. Пример:
  1. В конзолата ако напишете: FreeCAD.
  2. Ще се покаже диалогов прозорец с незадължителни класове/функции, от които да избирате
  3. Превъртете през списъка, за да прочетете описанието на всеки клас/функция
  4. Чрез избиране на функция и завършването ѝ с . може да повторите стъпки 2 и 3, за да навлезете по-дълбоко в API
• Tab/Word завършване се извършва с Ctrl+Space