Конзола за Python
Въведение
Конзолата за 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. Пример:
- В конзолата ако напишете:
FreeCAD. - Ще се покаже диалогов прозорец с незадължителни класове/функции, от които да избирате
- Превъртете през списъка, за да прочетете описанието на всеки клас/функция
- Чрез избиране на функция и завършването ѝ с
.може да повторите стъпки 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:
- Miscellaneous: Undo, Redo, Cut, Copy, Paste, Duplicate Object, Delete, Recompute, Box Selection, Box Element Selection, Select All, Transform, Placement, Align To, Send to Python Console, Properties, Toggle Edit Mode, Edit Mode, Preferences
- Create: New Part, New Group, Variable Set, Annotation Label, Text Document
- 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
- 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, 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
- 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
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
- Hubs: User hub, Power users hub, Developer hub