remove_unused()

Download Markdown

Removes bones that carry almost no weight from this mesh's influence list. A DCC connection is not required.

Only bones whose weight is numerically near zero are candidates. A parent stays if a child still has weight. For example, if a forearm segment has weight, the forearm bone is kept even when the forearm bone itself has none. The fallback bone is kept too.

removed on the result is the names that were actually removed.

Signature

skin.remove_unused() -> result

Field	Meaning
`ok`	Whether the removal finished.
`removed`	Names that were removed.
`not_found`	Names skipped because they were not in the list.
`error`	Why it failed.

Example

result = api.skin().remove_unused()
print(result.removed)

💬

Need help with the API?

Open a support ticket or join the community discussion.

Contact Support