🪧 Occlusion de texte des panneaux (Minecraft 26.3)
Dans Minecraft 26.3, les panneaux et panneaux suspendus intègrent une gestion de texte sur les deux faces (SignTextSlot.FRONT et SignTextSlot.BACK). Par défaut, le moteur de rendu typographique du jeu traite, ajuste et dessine les quads de texte, les teintures et les contours lumineux pour les deux faces simultanément — même lorsque le joueur regarde directement la face avant d'un panneau fixé contre un mur plein.
Camera Culling élimine ce gaspillage en calculant le produit scalaire des vecteurs normaux de face ($\vec{N} \cdot \vec{V}$) et en appliquant un filtre rapide pour les faces vides afin de ne pas rendre les textes masqués ou vierges.
📋 Fiche d'information de l'occlusion des panneaux
| Propriété | Valeur |
|---|---|
| Pipeline cible | BlockEntityRenderDispatcher.tryExtractRenderState |
| Angle de coupure avant/arrière | Seuil de produit scalaire à $\pm 0.05$ |
| Passage rapide face vide | Ignore automatiquement les faces ne contenant aucun caractère |
| Blocs pris en charge | Panneaux sur pied, muraux, suspendus au plafond et suspendus aux murs |
📐 Produit scalaire trigonométrique du vecteur normal
Pour déterminer si la face avant ou arrière d'un panneau est orientée vers la caméra, Camera Culling calcule le produit scalaire entre le vecteur normal de la face $\vec{N} = (N_x, N_z)$ et le vecteur reliant le centre du panneau à la caméra $\vec{V} = (V_x, V_z)$ :
$$V_x = X_{\text{cam} - (X_{\text{panneau} + 0.5), \quad V_z = Z_{\text{cam} - (Z_{\text{panneau} + 0.5)$$
1. Panneaux muraux (WallSignBlock.FACING) & suspendus muraux (WallHangingSignBlock.FACING)
Le vecteur normal est directement extrait des décalages directionnels de l'orientation du bloc (Direction) : $$N_x = \text{facing.getStepX()}, \quad N_z = \text{facing.getStepZ()}$$
2. Panneaux sur pied (StandingSignBlock.ROTATION) & suspendus au plafond (CeilingHangingSignBlock.ROTATION)
La rotation est représentée sous forme d'entier de $0 \dots 15$. L'angle $\theta$ en radians est calculé : $$\theta = \left(\frac{\text{rotation} \times 360^\circ}{16}\right) \times \frac{\pi}{180}$$ $$N_x = -\sin\theta, \quad N_z = \cos\theta$$
3. Détermination de la visibilité
Le produit scalaire $D$ évalue l'angle d'observation : $$D = N_x V_x + N_z V_z$$
- Évaluation de la face avant : Masquée lorsque $D < -0.05$ (la caméra est située derrière la face).
- Évaluation de la face arrière : Masquée lorsque $D > 0.05$ (la caméra est située devant la face).
⚡ Échec rapide pour face vide (Fast-Pass)
Si un joueur n'a écrit de texte que sur une seule face d'un panneau (ou s'il a posé un panneau vierge en tant qu'élément de décoration), Camera Culling inspecte les lignes de texte :
public static boolean isTextEmpty(SignText text) {
if (text == null) return true;
for (Component msg : text.getMessages(false)) {
if (msg != null && !msg.getString().trim().isEmpty()) {
return false;
}
}
return true;
}Les faces vierges sont immédiatement ignorées sans exécuter de calculs trigonométriques ou de produits scalaires.