File: convert.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (89 lines) | stat: -rw-r--r-- 2,268 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.. _object-convert-to:
.. _bpy.ops.object.convert:

*******
Convert
*******

Curve
=====

.. reference::

   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Convert --> Curve`

Converts the selected mesh, or text object to a curve object.
For mesh objects, only edges belonging to no faces will be taken into account.
The resulting curve will be a poly curve type, but can be converted to have
smooth segments as described in :ref:`bpy.ops.curve.spline_type_set`.


Mesh
====

.. reference::

   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Convert --> Mesh`

Converts the selected curve, metaball, surface, or text object to a mesh object.
The actual defined resolution of these objects will be taken into account for the conversion.
Note that it also keeps the faces and volumes created by closed and extruded curves.


Grease Pencil
=============

.. reference::

   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Convert --> Grease Pencil`

Converts the selected curve, mesh or text object to a Grease Pencil object
with strokes matching the curve, mesh, or text; basic materials are also added.
When multiple curves, meshes, or texts are selected, they are all converted into
the same Grease Pencil object.


Options
-------

Keep Original
   Duplicates the original object before converting it.
Thickness
   Strokes thickness.
Threshold Angle
   Threshold value that determines the strokes end.
Stroke Offset
   Sets offset to separate strokes from filled strokes.
Only Seam Edges
   Convert only edges marked as seam.
Export Faces
   Convert faces as filled strokes.


Trace Image to Grease Pencil
============================

.. reference::

   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Convert --> Trace Image to Grease Pencil`

See :doc:`/grease_pencil/modes/object/trace_image`.


.. _bpy.ops.image.convert_to_mesh_plane:

Convert to Mesh Plane
=====================

.. reference::

   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Convert --> Convert to Mesh Plane`

Converts the selected :ref:`image empty <bpy.types.Object.empty_image>` to a textured mesh plane.

For a description of the options see :doc:`/modeling/meshes/import_images_as_planes`.