Drawing Workbench/ru

Модуль Черчения позволяет поместить ваши 3D наработки на бумагу. То есть, поместить проекции ваших моделей в 2D окно и вставить это окно в рисунок, например на лист с рамкой, вашим заголовком и логотипом и наконец распечатать всё это. Модуль черчения находится в стадии разработки и приблизительного технологического тестирования!

Development of the Drawing Module has stopped, and a new TechDraw Module aiming to replace it will be introduced in version 0.17. Both modules will be provided in v0.17, but the Drawing module may be removed in future releases.

GUI Инструменты

Это инструменты для создания, настройки и экспортирования 2D чертежных листов

Открыть SVG: Открывает чертеж, ранее сохранённый в формате SVG

Новый чертеж A3: Создает чертёж формата A3 c шаблоном FreeCAD по умолчанию

Вставить вид в чертёж: Помещает вид выделенного объекта на активный лист чертежа.

Аннотация: Добавляет аннотацию на текущий чертёжный лист

Клип: Добавляет группу клипов на текущий чертёжный лист

Открыть в браузере: Открывает предварительный просмотр текущего чертёжного листа в браузере

Вставить ортографические виды: Автоматически создаёт ортографические виды объекта на текущем чертёжном листе

Символ: Добавляет содержимое файла SVG как символ на текущий чертёжный лист

Draft View: Вставляет специальный вид выбранного объекта на текущий чертёжный лист

Spreadsheet View: Вставляет вид выбранного листа электронной таблицы на текущий чертёжный лист

Экспортировать страницу: Сохраняет указанный лист в SVG формате

Проекция фигуры: Создаёт проекцию выбранного объекта (источинка) в трёхмерном виде.

Примечание Инструмент Draft View главным образом используется, чтобы поместить чертёжные объекты на бумагу. Он имеет множество дополнительных возможностей кроме стандартных чертёжных инструментов, и поддерживает специффические объекты вроде размеров на чертеже.

На картинке вы видите, основные концепции модуля Черчения. Документ содержит объект-форму (Schenkel) который мы хотим извлечь для черчения. Поэтому создается "Лист". Лист автоматически получает шаблон, в данном случае шаблон "A3_Landscape". Этот шаблон представляет собой документ SVG и может содержать обычную чертежную рамку, ваш логотип или же соответствовать вашим собственным стандартам.

На этот лист вы можете поместить один и более видов. Каждый вид обладает своей позицией на странице (свойства X,Y), и коэффициентом масштабирования (свойство scale) и другие дополнительные свойства. Каждый раз когда лист или вид или объект на который они ссылаются, изменяются лист перерисовывается, и отображение листа обновляется.

Написание сценариев

На данный момент рабочий процес для конечного пользователя(GUI) очень ограничен, поэтому интересней писать сценарии для API. Ниже следуют примеры о том как сценариев API чертежного модуля.

Это скрипт, с помощью которого можно легко заполнить лист Macro_CartoucheFC FreeCAD A3_Landscape.

Простейшие примеры

Прежде всего нам нужны модули Part и Drawing:

import FreeCAD, Part, Drawing

Создадим простую маленькую деталь

Part.show(Part.makeBox(100,100,100).cut(Part.makeCylinder(80,100)).cut(Part.makeBox(90,40,100)).cut(Part.makeBox(20,85,100)))

Прямая проекция. G0 будет жесткой гранью, а G1 непрерывно касается.

Shape = App.ActiveDocument.Shape.Shape
[visibleG0,visibleG1,hiddenG0,hiddenG1] = Drawing.project(Shape)
print "visible edges:", len(visibleG0.Edges)
print "hidden edges:", len(hiddenG0.Edges)

Всё помещено в проекцию на плоскость Z:

print "Bnd Box shape: X=",Shape.BoundBox.XLength," Y=",Shape.BoundBox.YLength," Z=",Shape.BoundBox.ZLength
print "Bnd Box project: X=",visibleG0.BoundBox.XLength," Y=",visibleG0.BoundBox.YLength," Z=",visibleG0.BoundBox.ZLength

Различные вектора проекции

[visibleG0,visibleG1,hiddenG0,hiddenG1] = Drawing.project(Shape,App.Vector(1,1,1))

Спроецировать в SVG

resultSVG = Drawing.projectToSVG(Shape,App.Vector(1,1,1))
print resultSVG

Параметрический метод

Создадим новое тело

import FreeCAD
import Part
import Drawing

# Create three boxes and a cylinder
App.ActiveDocument.addObject("Part::Box","Box")
App.ActiveDocument.Box.Length=100.00
App.ActiveDocument.Box.Width=100.00
App.ActiveDocument.Box.Height=100.00

App.ActiveDocument.addObject("Part::Box","Box1")
App.ActiveDocument.Box1.Length=90.00
App.ActiveDocument.Box1.Width=40.00
App.ActiveDocument.Box1.Height=100.00

App.ActiveDocument.addObject("Part::Box","Box2")
App.ActiveDocument.Box2.Length=20.00
App.ActiveDocument.Box2.Width=85.00
App.ActiveDocument.Box2.Height=100.00

App.ActiveDocument.addObject("Part::Cylinder","Cylinder")
App.ActiveDocument.Cylinder.Radius=80.00
App.ActiveDocument.Cylinder.Height=100.00
App.ActiveDocument.Cylinder.Angle=360.00
# Fuse two boxes and the cylinder
App.ActiveDocument.addObject("Part::Fuse","Fusion")
App.ActiveDocument.Fusion.Base = App.ActiveDocument.Cylinder
App.ActiveDocument.Fusion.Tool = App.ActiveDocument.Box1

App.ActiveDocument.addObject("Part::Fuse","Fusion1")
App.ActiveDocument.Fusion1.Base = App.ActiveDocument.Box2
App.ActiveDocument.Fusion1.Tool = App.ActiveDocument.Fusion
# Cut the fused shapes from the first box
App.ActiveDocument.addObject("Part::Cut","Shape")
App.ActiveDocument.Shape.Base = App.ActiveDocument.Box 
App.ActiveDocument.Shape.Tool = App.ActiveDocument.Fusion1
# Hide all the intermediate shapes 
Gui.ActiveDocument.Box.Visibility=False
Gui.ActiveDocument.Box1.Visibility=False
Gui.ActiveDocument.Box2.Visibility=False
Gui.ActiveDocument.Cylinder.Visibility=False
Gui.ActiveDocument.Fusion.Visibility=False
Gui.ActiveDocument.Fusion1.Visibility=False

вставляем на лист и добавляем шаблон

App.ActiveDocument.addObject('Drawing::FeaturePage','Page')
App.ActiveDocument.Page.Template = App.getResourceDir()+'Mod/Drawing/Templates/A3_Landscape.svg'

Создает вид на "Форму" объекта,определяем положение и масштаб и помещаем его на лист

App.ActiveDocument.addObject('Drawing::FeatureViewPart','View')
App.ActiveDocument.View.Source = App.ActiveDocument.Shape
App.ActiveDocument.View.Direction = (0.0,0.0,1.0)
App.ActiveDocument.View.X = 10.0
App.ActiveDocument.View.Y = 10.0
App.ActiveDocument.Page.addObject(App.ActiveDocument.View)

Создать второй вид на тот же объект, но на этот раз вид представление объекта будет повернуто на 90 градусов.

App.ActiveDocument.addObject('Drawing::FeatureViewPart','ViewRot')
App.ActiveDocument.ViewRot.Source = App.ActiveDocument.Shape
App.ActiveDocument.ViewRot.Direction = (0.0,0.0,1.0)
App.ActiveDocument.ViewRot.X = 290.0
App.ActiveDocument.ViewRot.Y = 30.0
App.ActiveDocument.ViewRot.Scale = 1.0
App.ActiveDocument.ViewRot.Rotation = 90.0
App.ActiveDocument.Page.addObject(App.ActiveDocument.ViewRot)

Создание третьего вида на данный объект , но с изометрической точки зрения. Также активируем скрытые линии.

App.ActiveDocument.addObject('Drawing::FeatureViewPart','ViewIso')
App.ActiveDocument.ViewIso.Source = App.ActiveDocument.Shape
App.ActiveDocument.ViewIso.Direction = (1.0,1.0,1.0)
App.ActiveDocument.ViewIso.X = 335.0
App.ActiveDocument.ViewIso.Y = 140.0
App.ActiveDocument.ViewIso.ShowHiddenLines = True
App.ActiveDocument.Page.addObject(App.ActiveDocument.ViewIso)

Изменим кое-что и обновим. В процессе обновления, изменится отображение и лист.

App.ActiveDocument.View.X = 30.0
App.ActiveDocument.View.Y = 30.0
App.ActiveDocument.View.Scale = 1.5
App.ActiveDocument.recompute()

Получение доступа к битам и деталям

Получить SVG фрагмент первого вида

ViewSVG = App.ActiveDocument.View.ViewResult
print ViewSVG

Получить весь лист (это файл в во временном каталоге документа, доступный только для чтения)

print "Resulting SVG document: ",App.ActiveDocument.Page.PageResult
file = open(App.ActiveDocument.Page.PageResult,"r")
print "Result page is ",len(file.readlines())," lines long"

Важно : освобождаем файл!

del file

Вставить вид с вашим собственным содержанием:

App.ActiveDocument.addObject('Drawing::FeatureView','ViewSelf')
App.ActiveDocument.ViewSelf.ViewResult = """<g id="ViewSelf"
  stroke="rgb(0, 0, 0)"
  stroke-width="0.35"
  stroke-linecap="butt"
  stroke-linejoin="miter"
  transform="translate(30,30)"
  fill="#00cc00"
  >

  <ellipse cx="40" cy="40" rx="30" ry="15"/>
  </g>"""
App.ActiveDocument.Page.addObject(App.ActiveDocument.ViewSelf)
App.ActiveDocument.recompute()

del ViewSVG

Это приводит к следующим результатам:

Размеры и допуска

Чертёжные размеры и допуска еще в стадии проектирования, но Вы можете получить некоторую базовую функциональность при помощи небольшой работы.

Сначала Вам нужно взять отсюда модуль python под названием gdtsvg (ВНИМАНИЕ: Он может оказаться испорченным в любой момент!):

https://github.com/jcc242/FreeCAD

Чтобы получить контрольную рамку, попробуйте следующее:

import gdtsvg as g # Import the module, I like to give it an easy handle
ourFrame = g.ControlFrame("0","0", g.Perpendicularity(), ".5", g.Diameter(), g.ModifyingSymbols("M"), "A",  
           g.ModifyingSymbols("F"), "B", g.ModifyingSymbols("L"), "C", g.ModifyingSymbols("I"))

Here is a good breakdown of the contents of a feature control frame: http://www.cadblog.net/adding-geometric-tolerances.htm

Параметры, отправляемые в кадр управления, следующие:

Координата X в координатной системе SVG (строковый тип)
Координата Y в координатной системе SVG (строковый тип)
Требуемый символ геометрической характеристики (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)
Допуск (тип string)
(опционально) символ диаметра (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)
(опционально) Условия изменения материала (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)
(опционально) The first datum (строковый тип)
(опционально) The first datum's modifying condition (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)
(опционально) The second datum (строковый тип)
(опционально) The second datum's modifying condition (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)
(опционально) The third datum (строковый тип)
(опционально) The third datum's material condition (кортеж, сначала строка SVG, затем ширина символа, затем высота символа)

The ControlFrame function returns a type containing (svg string, overall width of control frame, overall height of control frame)

Чтобы получить размер, попробуйте следующее:

import gdtsvg
ourDimension = linearDimension(point1, point2, textpoint, dimensiontext, linestyle=getStyle("visible"), 
               arrowstyle=getStyle("filled"), textstyle=getStyle("text")

Inputs for linear dimension are:

point1, an (x,y) tuple with svg-coordinates, this is one of the points you would like to dimension between
point2, an (x,y) tuple with svg-coordinates, this is the second point you would like to dimension between
textpoint, an (x,y) tuple of svg-coordinates, this is where the text of your dimension will be
dimensiontext, a string containing the text you want the dimension to say
linestyle, a string containing svg (i.e. css) styles, using the getStyle function to retrieve a preset string, for styling the how the lines look
arrowstyle, a string containing svg (i.e. css) styles, using the getStyle function to retrieve a preset string, for styling how the arrows look
textstyle, a string containing svg (i.e. css) styles, using the getStyle function to retrieve a preset string, for styling how the text looks

With those two, you can proceed as above for displaying them on the drawing page. This module is very buggy and can be broken at any given moment, bug reports are welcome on the github page for now, or contact jcc242 on the forums if you post a bug somewhere else.

Шаблоны

FreeCAD поставляется вместе с набором стандартных шаблонов, но вы также можете найти больше на странице Чертежных шаблонов .

Расширение модуля Drawing

Некоторые примечания по программной стороне модуля были добавлены на страницу Drawing Documentation. Это для быстрого понимания, как работает модуль Drawing, позволяя программистам быстро начать программирование для него.

Учебники

Учебник по модулю Drawing

Внешние ссылки

Intro to mechanical drawing on Youtube - by Normal Universe