UV: Document pack islands features and new ui #104468

Closed
Chris Blackbourn wants to merge 63 commits from Chris_Blackbourn/blender-manual:uv_pack_islands into blender-v3.6-release

When changing the target branch, be careful to rebase the branch in your fork to match. See documentation.
Showing only changes of commit 6c0a8f5fb6 - Show all commits

View File

@ -15,6 +15,8 @@ Most of the settings in the *Shape* panel are shared with those of
:doc:`Curves </modeling/curves/properties/shape>` :doc:`Curves </modeling/curves/properties/shape>`
data-blocks, please refer to those for details. data-blocks, please refer to those for details.
.. _bpy.types.TextCurve.use_fast_edit:
Fast Editing Fast Editing
Does not fill the letters in Edit Mode, only show their outline. Does not fill the letters in Edit Mode, only show their outline.
@ -101,16 +103,31 @@ but you have to choose between different styles of a same font, or different fon
Blender has a number of typographic controls for changing the style and layout of text, Blender has a number of typographic controls for changing the style and layout of text,
found in the *Font* panel. found in the *Font* panel.
.. _bpy.types.TextCharacterFormat.use_bold:
Bold Bold
Toggled with the *Bold* button before typing. Text can also be set to Toggled with the *Bold* button before typing. Text can also be set to
**bold** by selecting it then using the *Bold* entry in the *Text* menu of **bold** by selecting it then using the *Bold* entry in the *Text* menu of
the 3D Viewport. the 3D Viewport.
Italics
.. _bpy.types.TextCharacterFormat.use_italic:
Italic
Toggled with the *Italic* button before typing. Text can also be set to Toggled with the *Italic* button before typing. Text can also be set to
*italic* by selecting it then using the *Italic* entry in the *Text* menu of *italic* by selecting it then using the *Italic* entry in the *Text* menu of
the 3D Viewport. the 3D Viewport.
.. _bpy.types.TextCharacterFormat.use_underline:
Underline Underline
Enables underlining, as controlled by the :ref:`underline settings <modeling-text-character-underline>` below. Toggled with the *Underline* button before typing.
Text can also be set to Underlined by selecting it
then using the *Underline* entry in the *Text* menu of the 3D Viewport.
See also :ref:`underline settings <modeling-text-character-underline>` below.
.. _bpy.types.TextCharacterFormat.use_small_caps:
Small Caps Small Caps
Enable this option to type characters as small caps. Enable this option to type characters as small caps.
@ -121,9 +138,14 @@ Small Caps
Transform Transform
--------- ---------
.. _bpy.types.TextCurve.size:
Size Size
Controls the size of the whole text (no way to control each char size independently). Controls the size of the whole text (no way to control each char size independently).
Note however, that chars with different fonts (different styles, see below) might have different visible sizes. Note however, that chars with different fonts (different styles, see below) might have different visible sizes.
.. _bpy.types.TextCurve.shear:
Shear Shear
Controls the inclination of the whole text. Controls the inclination of the whole text.
As similar as it may seem, this is not the same thing as italics style. As similar as it may seem, this is not the same thing as italics style.
@ -133,6 +155,8 @@ Shear
Shear example. Shear example.
.. _bpy.types.TextCurve.family:
Object Font Object Font
Allows individual objects to be used to render fonts, you can create/model your own complex font inside Blender! Allows individual objects to be used to render fonts, you can create/model your own complex font inside Blender!
This field is used to select the objects prefix name (object "family") to be used This field is used to select the objects prefix name (object "family") to be used
@ -153,6 +177,8 @@ Object Font
The objects are duplicated so that their center is positioned at The objects are duplicated so that their center is positioned at
the *lower right corner* of the corresponding characters. the *lower right corner* of the corresponding characters.
.. _bpy.types.TextCurve.follow_curve:
Text on Curve Text on Curve
Select a curve object for the text object to follow. Select a curve object for the text object to follow.
@ -167,15 +193,18 @@ Text on Curve
which offers more control, and is the standard way to achieve such effects in modern Blender. which offers more control, and is the standard way to achieve such effects in modern Blender.
.. _modeling-text-character-underline: .. _modeling-text-character-underline:
.. _bpy.types.TextCurve.underline_position:
Underline
Toggled with the *Underline* button before typing.
Text can also be set to Underlined by selecting it
then using the *Underline* entry in the *Text* menu of the 3D Viewport.
Underline Position Underline Position
This allows you to shift vertically the position of the underline. This allows you to shift vertically the position of the underline.
.. _py.types.TextCurve.underline_height:
Underline Thickness Underline Thickness
This controls the thickness of the underline. This controls the thickness of the underline.
.. _bpy.types.TextCurve.small_caps_scale:
Small Caps Scale Small Caps Scale
The scaling applied to capital letters to turn them into small caps. The scaling applied to capital letters to turn them into small caps.
@ -198,6 +227,8 @@ The *Paragraph* Panel has settings for the alignment and spacing of text.
Alignment Alignment
--------- ---------
.. _bpy.types.TextCurve.align_x:
Horizontal Horizontal
:Left: :Left:
Aligns text to the left of the frames when using them, Aligns text to the left of the frames when using them,
@ -218,6 +249,8 @@ Horizontal
.. note:: Both *Justify* and *Flush* only work within frames. .. note:: Both *Justify* and *Flush* only work within frames.
.. _bpy.types.TextCurve.align_y:
Vertical Vertical
:Top: :Top:
- With text boxes, aligns the top of the text to the top of the frames. - With text boxes, aligns the top of the text to the top of the frames.
@ -247,16 +280,27 @@ Vertical
Spacing Spacing
------- -------
.. _bpy.types.TextCurve.space_character:
Character Spacing Character Spacing
A factor by which space between each character (kerning) is scaled in width. A factor by which space between each character (kerning) is scaled in width.
In Edit Mode in the 3D Viewport, you can also control individual kerning In Edit Mode in the 3D Viewport, you can also control individual kerning
at text cursor position by pressing :kbd:`Alt-Left` / :kbd:`Alt-Right` to decrease/increase it. at text cursor position by pressing :kbd:`Alt-Left` / :kbd:`Alt-Right` to decrease/increase it.
.. _bpy.types.TextCurve.space_word:
Word Spacing Word Spacing
A factor by which whitespace between words is scaled in width. A factor by which whitespace between words is scaled in width.
.. _bpy.types.TextCurve.space_line:
Line Spacing Line Spacing
A factor by which the vertical space between lines is scaled. A factor by which the vertical space between lines is scaled.
.. _bpy.types.TextCurve.offset_x:
.. _bpy.types.TextCurve.offset_y:
Offset X, Y Offset X, Y
These settings control the X and Y offset of the text position within the object. These settings control the X and Y offset of the text position within the object.
This applies relatively to the object's origin, either to the whole text or, when using text boxes, to each frame. This applies relatively to the object's origin, either to the whole text or, when using text boxes, to each frame.
@ -284,13 +328,19 @@ If the last frame is reached, text overflows out of it (by default, see options
Text Boxes panel. Text Boxes panel.
.. _bpy.ops.font.textbox_add:
Add Textbox Add Textbox
Inserts a new frame, just after the current one (in text flow order). Inserts a new frame, just after the current one (in text flow order).
The new frame will have the same size and position as the selected one. The new frame will have the same size and position as the selected one.
.._bpy.ops.font.textbox_remove:
Delete ``X`` Delete ``X``
Delete the current frame. Delete the current frame.
.. _bpy.types.TextCurve.overflow:
Overflow Overflow
How to handle text overflowing available space in the defined boxes. How to handle text overflowing available space in the defined boxes.
@ -306,10 +356,15 @@ Overflow
It will only truncate in *Object Mode*, It will only truncate in *Object Mode*,
in *Edit Mode* the whole text remains visible (and overflows as needed). in *Edit Mode* the whole text remains visible (and overflows as needed).
.. _bpy.types.TextBox.width:
Size X, Y Size X, Y
Specifies the width and height of the text box, if set to **zero** no word wrapping happens Specifies the width and height of the text box, if set to **zero** no word wrapping happens
(it is ignored, and the whole text box system is disabled if all are set to a null size). (it is ignored, and the whole text box system is disabled if all are set to a null size).
.. _bpy.types.TextBox.x:
.. _bpy.types.TextBox.y:
Offset X, Y Offset X, Y
Controls the *X* and *Y* offset of the frame, i.e. its position. Controls the *X* and *Y* offset of the frame, i.e. its position.