Python Console/bg

Въведение

Конзолата за 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

Interface

• Preferences Editor, Interface Customization
• Main window: Standard menu, Main view area, 3D View, Combo view (Tree View, Task Panel, Property View), Selection view, Report View, Python console, Status Bar, DAG View, Workbench Selector
• Auxiliary windows: Scene inspector, Dependency graph

Std Base

• File: New Document, Open, Open Recent, Close, Close All, Save, Save As, Save Copy, Save All, Revert, Import, Export,Merge Document, Document Information, Print, Print Preview, Export PDF, Exit

---

• Edit: Undo, Redo, Cut, Copy, Paste, Duplicate Object, Recompute, Box Selection, Box Element Selection, Select All, Delete, Send to Python Console, Placement, Transform, Align To, Toggle Edit Mode, Properties, Edit Mode, Preferences

---

• View:
  • Miscellaneous: New 3D View, Orthographic View, Perspective View, Fullscreen, Bounding Box, Toggle Axis Cross, Clipping View, Texture Mapping, Toggle Navigation/Edit Mode, Material, Appearance, Random Color, Appearance per Face, Toggle Transparency, Workbench, Status Bar
  • Standard Views: Fit All, Fit Selection, Align to Selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right, Store Working View, Recall Working View
  • Freeze Display: Save Views, Load Views, Freeze View, Clear Views
  • Draw Style: As Is, Points, Wireframe, Hidden Line, No Shading, Shaded, Flat Lines
  • Stereo: Stereo Red/Cyan, Stereo Quad Buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue Camera Position
  • Zoom: Zoom In, Zoom Out, Box Zoom
  • Document Window: Docked, Undocked, Fullscreen
  • Visibility: Toggle Visibility, Show Selection, Hide Selection, Select Visible Objects, Toggle All Objects, Show All Objects, Hide All Objects, Toggle Selectability
  • Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Individual Views, Structure, Help, Lock Toolbars
  • Panels: Tree View, Property View, Model, Selection View, Python Console, Report View, Tasks, DAG View
  • Overlay Docked Panel: Toggle Overlay for All Panels, Toggle Transparent Panels, Toggle Overlay, Toggle Transparent Mode, Bypass Mouse Events in Overlay Panels, Toggle Left, Toggle Right, Toggle Top, Toggle Bottom
  • Link Navigation: Go to Linked Object, Go to Deepest Linked Object, Select All Links
  • Tree View Actions: Sync View, Sync Selection, Sync Placement, Preselection, Record Selection, Single Document, Multi Document, Collapse/Expand, Initiate Dragging, Go to Selection, Selection Back, Selection Forward

---

• Tools: Addon Manager, Measure, Clarify Selection, Quick Measure, Units Converter, Load Image, Save Image, Text Document, View Turntable, Scene Inspector, Dependency Graph, Export Dependency Graph, Document Utility, Edit Parameters, Customize

---

• Macro: Record Macro, Macros, Recent Macros, Execute Macro, Attach to Remote Debugger, Debug Macro, Stop Debugging, Step Over, Step Into, Toggle Breakpoint

---

• Windows: Next, Previous, Tile, Cascade, Choose Open Window

---

• Help: What's This, Start Page, Users Documentation, FreeCAD Forum, Report an Issue, Restart in Safe Mode, Developers Handbook, Python Modules Documentation, FreeCAD Website, Donate to FreeCAD, About FreeCAD

---

• Additional:
  • Miscellaneous: New Part, New Group, Variable Set, Link Group, Select All Instances, Toggle Freeze
  • Datums: Coordinate System, Datum Plane, Datum Line, Datum Point
  • Link Actions: Make Link, Make Sub-Link, Replace With Link, Unlink, Import Link, Import All Links
  • Expression Actions: Copy Selected, Copy Active Document, Copy All Documents, Paste
  • Selection Filter: Vertex Selection, Edge Selection, Face Selection, No Selection Filters

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub