c4d.UVWTag¶

class c4d.UVWTag¶: Represents the UVW tag.

Handles the UVW coordinates for textures.

Note

When assigning a UVW tag to an object ensure the texture is set to UVW.

The instance object class of type Tuvw.

Methods Signatures

UVWTag.__init__(self, count)

type count: int

`UVWTag.GetSlow(self, i)`	Get the UVW coordinate for a polygon.
`UVWTag.SetSlow(self, i, a, b, c, d)`	Set the UVW coordinates of a polygon.
`UVWTag.CpySlow(self, i, srctag, src)`	Copy a UVW coordinate.
`UVWTag.ClearPinSelection(self)`	Clears the pin point selection for this tag.
`UVWTag.SetPinSelection(self, uvPointSelection)`	Replaces the pin point selection for this tag with the point selection specified.
`UVWTag.AddToPinSelection(self, uvPointSelection)`	Adds the point selection specified to the pin point selection.
`UVWTag.RemoveFromPinSelection(self, uvPointSelection)`	Removes from the pin point selection the points in the selection specified.
`UVWTag.GetPinSelection(self)`	Obtains the current pin point selection for this tag.

Inheritance

Parent Class:

c4d.VariableTag

Methods Documentation

UVWTag.__init__(self, count)¶

Parameters: count (int) – The number of elements in the tag.

UVWTag.GetSlow(self, i)¶

Get the UVW coordinate for a polygon.

>>> op
<c4d.PolygonObject object called Plane/Polygon with ID 5100 at 1694970385536>
>>> tag = op.GetTag(c4d.Tuvw)
>>> tag
<c4d.UVWTag object called UVW/UVW with ID 5671 at 1694956664000>
>>> for i in range(tag.GetDataCount()):
...     print(tag.GetSlow(i))
...
{'a': Vector(0, 1, 0), 'b': Vector(0, 0, 0), 'c': Vector(1, 0, 0), 'd': Vector(1, 1, 0)}

Parameters: i (int) – The index of the polygon to get the coordinates for.
Raises: IndexError – If i is out of range : 0<=i<VariableTag.GetDataCount().
Return type: dict{a: Vector, b: Vector, c: Vector, d: Vector}
Returns: The UVW coordinates.

UVWTag.SetSlow(self, i, a, b, c, d)¶

Set the UVW coordinates of a polygon.

Parameters

i (int) – The index of the polygon to set the coordinates for.
a (c4d.Vector) – The coordinate of the first point.
b (c4d.Vector) – The coordinate of the second point.
c (c4d.Vector) – The coordinate of the third point.
d (c4d.Vector) – The coordinate of the fourth point.

Raises

IndexError – If i is out of range : 0<=i<VariableTag.GetDataCount().

UVWTag.CpySlow(self, i, srctag, src)¶

Copy a UVW coordinate.

Parameters

i (int) – The destinate polygon index in this UVWTag.
srctag (c4d.UVWTag) – The UVWTag for the source polygon.
src (int) – The source polygon index in this UVWTag.

Raises

IndexError – If i is out of range (0<=i<VariableTag.GetDataCount()) for self and/or src.

UVWTag.ClearPinSelection(self)¶: Clears the pin point selection for this tag.

New in version S22.114.

UVWTag.SetPinSelection(self, uvPointSelection)¶

Replaces the pin point selection for this tag with the point selection specified.

New in version S22.114.

Parameters: uvPointSelection (c4d.BaseSelect) – New pin selection to set.
Returns: True on success.
Return type: bool

UVWTag.AddToPinSelection(self, uvPointSelection)¶

Adds the point selection specified to the pin point selection.

New in version S22.114.

Parameters: uvPointSelection (c4d.BaseSelect) – Pin selection to add.
Returns: True on success.
Return type: bool

UVWTag.RemoveFromPinSelection(self, uvPointSelection)¶

Removes from the pin point selection the points in the selection specified.

New in version S22.114.

Note

Points in the specified selection that are not part of the current pin point selection are simply ignored.

Parameters: uvPointSelection (c4d.BaseSelect) – Pin point selection to remove.
Returns: True on success.
Return type: bool

UVWTag.GetPinSelection(self)¶

Obtains the current pin point selection for this tag.

New in version S22.114.

Returns: A non-writable reference to the pin selection.
Return type: c4d.BaseSelect