Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add note to CanvasItem.clip_children about nesting #98948

Merged
merged 1 commit into from
Nov 12, 2024

Conversation

Meorge
Copy link
Contributor

@Meorge Meorge commented Nov 8, 2024

I ran into an issue over the last few days that I eventually figured out was due to CanvasItems that clipped their children not being able to be nested. This doesn't appear to be noted in the documentation; the closest thing I could find was the page for CanvasGroup implying it.

This PR adds a note to the documentation for CanvasItem.clip_children explaining that clipping can't be nested, and that children of a clipping node must have CLIP_CHILDREN_DISABLED as their clip mode. It appears on the tooltip for the "Clip Children" in the Inspector:
CleanShot 2024-11-07 at 20 14 42@2x

@Meorge Meorge requested a review from a team as a code owner November 8, 2024 04:22
@AThousandShips AThousandShips added enhancement documentation cherrypick:4.2 Considered for cherry-picking into a future 4.2.x release cherrypick:4.3 Considered for cherry-picking into a future 4.3.x release labels Nov 8, 2024
@AThousandShips AThousandShips added this to the 4.4 milestone Nov 8, 2024
AThousandShips
AThousandShips previously approved these changes Nov 8, 2024
@Meorge
Copy link
Contributor Author

Meorge commented Nov 9, 2024

Should I expand this note to also indicate that the node cannot have an ancestor CanvasGroup if it is clipping?

@AThousandShips
Copy link
Member

I think that would be good

@Mickeon
Copy link
Contributor

Mickeon commented Nov 10, 2024

I would recommend to squash your commits, too. See the Pull Request Workflow.

@Meorge Meorge force-pushed the docs-clip-children branch from f052312 to f96c2a4 Compare November 10, 2024 17:49
Add CanvasGroup information to clipping note
Copy link
Contributor

@Mickeon Mickeon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reasonably to the point

@Repiteo Repiteo merged commit 3e7d68d into godotengine:master Nov 12, 2024
20 checks passed
@Repiteo
Copy link
Contributor

Repiteo commented Nov 12, 2024

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cherrypick:4.2 Considered for cherry-picking into a future 4.2.x release cherrypick:4.3 Considered for cherry-picking into a future 4.3.x release documentation enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants