Skip to content

Add on screen only option to getElementsByType#4746

Open
ArranTuna wants to merge 3 commits intomultitheftauto:masterfrom
ArranTuna:onScreenOnly
Open

Add on screen only option to getElementsByType#4746
ArranTuna wants to merge 3 commits intomultitheftauto:masterfrom
ArranTuna:onScreenOnly

Conversation

@ArranTuna
Copy link
Collaborator

Summary

I suggested onClientElementEnterScreen #678 but in the comments suggested that an option in getElementsByType to return on screen only would be good.

Motivation

There are scripts that try to be more efficient by applying things to only elements that are on screen, for example a script that renders text above a players head currently would have to do getElementsByType("player", root, true) and call isElementOnScreen on that list, as this is being done every frame that's inefficient. This change allows you to just do: getElementsByType("player", root, true, true) to get only on screen elements.

Test plan

This is an easy to test change, at first I just compared the sizes of #getElementsByType("ped", root, true) and #getElementsByType("ped", root, true, true) while turning camera to see it worked correctly, I then used createBlipAttachedTo to make sure the actually on screen elements were the ones in the table.

@ArranTuna ArranTuna requested a review from a team as a code owner March 7, 2026 12:19
@ArranTuna ArranTuna added the enhancement New feature or request label Mar 10, 2026
@Dutchman101
Copy link
Member

I like the idea, ill code-review it soon

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants