Mesh Scripting/ru: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{Docnav/ru
|[[FreeCAD Scripting Basics/ru|FreeCAD Scripting Basics]]
|[[Topological data scripting/ru|Topological data scripting]]}}
</div>


{{TOCright}}
{{TOCright}}


==Введение==
<div class="mw-translate-fuzzy">
=== Введение ===
</div>


Чтобы получить доступ к модулю {{incode|Mesh}}, вы должны сначала импортировать его:
Прежде всего вы должны импортировать Mesh модуль:


{{Code|code=
{{Code|code=
Line 18: Line 11:
}}
}}


==Создание==
После этого вы получаете доступ к Mesh модулю и классам Mesh которые сообщаются с с функциями FreeCAD C++ Mesh-Kernel.


Чтобы создать пустой объект сетки, просто используйте стандартный конструктор:
<div class="mw-translate-fuzzy">
=== Создание и Загрузка ===
Чтобы создать простейший полигонный(сеточный) объект, просто используйте стандартный конструктор:
</div>


{{Code|code=
{{Code|code=
Line 29: Line 19:
}}
}}


Вы также можете создать объект из файла
Вы также можете создать объект из файла:


{{Code|code=
{{Code|code=
mesh = Mesh.Mesh('D:/temp/Something.stl')
mesh = Mesh.Mesh("D:/temp/Something.stl")
}}
}}

Какие файловые форматы вы можете использовать для создания полигиональных объектов написано [[Feature_list#Key features|здесь]].


Или создайте его из множества треугольников, задав их вершины:
Или создайте его из множества треугольников, задав их вершины:


{{Code|code=
{{Code|code=
planarMesh = [
triangles = [
# triangle 1
# triangle 1
[-0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000],[-0.5000,0.5000,0.0000],
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
#triangle 2
[-0.5000,-0.5000,0.0000],[0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000],
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
]
planarMeshObject = Mesh.Mesh(planarMesh)
meshObject = Mesh.Mesh(triangles)
Mesh.show(planarMeshObject)
Mesh.show(meshObject)
}}
}}


Mesh-Ядро заботится о создании топологического правильной структуры данных сортируя
Ядро Mesh заботится о создании топологического правильной структуры данных, сортируя
совпадающие точки и края вместе.
совпадающие точки и края.
{{Top}}
==Моделирование==


Для создания правильной геометрии вы можете использовать один из методов {{incode|create*()}}. Например, тор можно создать следующим образом:
Позже вы увидете как можно протестировать и изучить полигиональные(сеточные) данные.

<div class="mw-translate-fuzzy">
=== Моделирование ===
Для создания обычной геометрии вы можете использовать Python сценарий BuildRegularGeoms.py.
</div>

To create regular geometries you can use the Python script BuildRegularGeoms.py.


{{Code|code=
{{Code|code=
m = Mesh.createTorus(8.0, 2.0, 50)
import BuildRegularGeoms
Mesh.show(m)
}}
}}


Первые два параметра определяют радиусы тороида, а третий параметр - фактор подвыборки, как много треугольников будет создано. Чем выше это значение, тем сглаженней тело.
Этот сценарий предоставляет методы для определения простых тел вращения, таких как сферы, элипсоиды, цилиндры, тороиды и конусы. И он также обладает методом для создания простого куба.
Чтобы создать тороид, например, следующим образом:


Модуль {{incode|Mesh}} также предоставляет три булевых метода: {{incode|union()}}, {{incode|intersection()}} и {{incode|difference()}}:
{{Code|code=
t = BuildRegularGeoms.Toroid(8.0, 2.0, 50) # list with several thousands triangles
m = Mesh.Mesh(t)
}}

Первые два параметра определяют радиусы тороида а третий параметр фактор подвыборки , как много треугольников будет создано. Чем выше это значение тем сглаженней и наоброт чем ниже тем грубее тело.
Mesh классы предоставляют набор логических функций которые могут быть использовыны в целях моделирования. Они обеспечивают объединение, пересечение и вычитание двух полигиональных объектов.


{{Code|code=
{{Code|code=
Line 89: Line 66:
}}
}}


Вот пример, который создает трубку, используя метод {{incode|difference()}}:
Наконец, полный пример, который вычисляет пересечение сферы и цилиндра, пересекающего сферу.


{{Code|code=
{{Code|code=
import Mesh, BuildRegularGeoms
import FreeCAD, Mesh
sphere = Mesh.Mesh( BuildRegularGeoms.Sphere(5.0, 50) )
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylinder = Mesh.Mesh( BuildRegularGeoms.Cylinder(2.0, 10.0, True, 1.0, 50) )
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
diff = sphere
pipe = cylA
diff = diff.difference(cylinder)
pipe = pipe.difference(cylB)
d = FreeCAD.newDocument()
pipe.flipNormals() # somehow required
d.addObject("Mesh::Feature","Diff_Sphere_Cylinder").Mesh=diff
doc = FreeCAD.ActiveDocument
d.recompute()
obj = d.addObject("Mesh::Feature", "Pipe")
obj.Mesh = pipe
doc.recompute()
}}
}}
{{Top}}
==Примечания==


Широко применяемый, хотя и трудный в использовании, источник скриптов обработки полигональных сеток - это тестовые скрипты в модуле {{incode|Mesh}}.
<div class="mw-translate-fuzzy">
В этих тестах модуля буквально все методы вызываются и все свойства/атрибуты перебираются.
=== Изучение и Тестирование ===
</div>

== Создание собственных Алгоритмов ==

== Экспортирование ==
Вы также можете записать полигональную модель как модуль Python:

{{Code|code=
m.write("D:/Develop/Projekte/FreeCAD/FreeCAD_0.7/Mod/Mesh/SavedMesh.py")
import SavedMesh
m2 = Mesh.Mesh(SavedMesh.faces)
}}

== Всё связанное с интерфейсом ==

<div class="mw-translate-fuzzy">
=== Всякая всячина ===
Трудно, широко использовать источники полигональной модели связанные с сценарием, все это тестирование написания сценариев для полигонального модуля
В этих тестах модуля буквально все методы вызываются и все свойства/атрибуты вымышлены.
Так что если вы достаточно смелы, взгляните на [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Mesh/App/MeshTestsApp.py Unit Test module].
Так что если вы достаточно смелы, взгляните на [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Mesh/App/MeshTestsApp.py Unit Test module].
</div>


Смотрите так же: [[Mesh_API/ru|Mesh API]].
An extensive (though hard to use) source of Mesh related scripting are the unit test scripts of the Mesh-Module.
{{Top}}
In this unit tests literally all methods are called and all properties/attributes are tweaked.
So if you are bold enough, take a look at the [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Mesh/App/MeshTestsApp.py Unit Test module].

See also [[Mesh_API|Mesh API]]

{{Docnav/ru
|[[FreeCAD_Scripting_Basics/ru|FreeCAD Scripting Basics]]
|[[Topological_data_scripting/ru|Topological data scripting]]
}}

{{Mesh Tools navi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
{{Mesh Tools navi{{#translation:}}}}
{{clear}}
{{clear}}

Latest revision as of 08:28, 5 September 2021

Введение

Чтобы получить доступ к модулю Mesh, вы должны сначала импортировать его:

import Mesh

Создание

Чтобы создать пустой объект сетки, просто используйте стандартный конструктор:

mesh = Mesh.Mesh()

Вы также можете создать объект из файла:

mesh = Mesh.Mesh("D:/temp/Something.stl")

Или создайте его из множества треугольников, задав их вершины:

triangles = [
# triangle 1
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
meshObject = Mesh.Mesh(triangles)
Mesh.show(meshObject)

Ядро Mesh заботится о создании топологического правильной структуры данных, сортируя совпадающие точки и края.

наверх

Моделирование

Для создания правильной геометрии вы можете использовать один из методов create*(). Например, тор можно создать следующим образом:

m = Mesh.createTorus(8.0, 2.0, 50)
Mesh.show(m)

Первые два параметра определяют радиусы тороида, а третий параметр - фактор подвыборки, как много треугольников будет создано. Чем выше это значение, тем сглаженней тело.

Модуль Mesh также предоставляет три булевых метода: union(), intersection() и difference():

m1, m2              # are the input mesh objects
m3 = Mesh.Mesh(m1)  # create a copy of m1
m3.unite(m2)        # union of m1 and m2, the result is stored in m3
m4 = Mesh.Mesh(m1)
m4.intersect(m2)    # intersection of m1 and m2
m5 = Mesh.Mesh(m1)
m5.difference(m2)   # the difference of m1 and m2
m6 = Mesh.Mesh(m2)
m6.difference(m1)   # the difference of m2 and m1, usually the result is different to m5

Вот пример, который создает трубку, используя метод difference():

import FreeCAD, Mesh
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
pipe = cylA
pipe = pipe.difference(cylB)
pipe.flipNormals() # somehow required
doc = FreeCAD.ActiveDocument
obj = d.addObject("Mesh::Feature", "Pipe")
obj.Mesh = pipe
doc.recompute()

наверх

Примечания

Широко применяемый, хотя и трудный в использовании, источник скриптов обработки полигональных сеток - это тестовые скрипты в модуле Mesh. В этих тестах модуля буквально все методы вызываются и все свойства/атрибуты перебираются. Так что если вы достаточно смелы, взгляните на Unit Test module.

Смотрите так же: Mesh API.

наверх