• Select the tokens of the active scene that represent a given actor.

    • A synthetic (token) actor is represented by exactly the single token it is embedded in. Pass that token as embeddedToken; it is returned only when it is actually present in sceneTokens (i.e. it belongs to the active scene), otherwise the result is empty.
    • A world (linked) actor is represented by every linked token on the active scene whose actorId matches. Pass embeddedToken as null.

    Type Parameters

    Parameters

    • sceneTokens: readonly T[]

      The active scene's token documents.

    • actorId: string

      The world actor's id (used only for the linked case).

    • embeddedToken: null | T

      The synthetic actor's own token, or null for a world actor.

    Returns T[]

    The matching tokens (empty array when none match).