View.SetCameraDistance(Single) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la distance le long de l’axe Z (orthogonal au plan X/Y sur lequel les vues sont dessinées) de la caméra à cette vue.
[Android.Runtime.Register("setCameraDistance", "(F)V", "GetSetCameraDistance_FHandler")]
public virtual void SetCameraDistance(float distance);[<Android.Runtime.Register("setCameraDistance", "(F)V", "GetSetCameraDistance_FHandler")>]
abstract member SetCameraDistance : single -> unit
override this.SetCameraDistance : single -> unitParamètres
- distance
- Single
Distance en « pixels de profondeur », si la valeur opposée est utilisée
- Attributs
Remarques
Définit la distance le long de l’axe Z (orthogonal au plan X/Y sur lequel les vues sont dessinées) de la caméra à cette vue. La distance de la caméra affecte les transformations 3D, par exemple les rotations autour de l’axe X et Y. Si les propriétés rotationX ou rotationY sont modifiées et que cette vue est grande (plus de la moitié de la taille de l’écran), il est recommandé d’utiliser toujours une distance de caméra supérieure à la hauteur (rotation de l’axe X) ou la largeur (rotation de l’axe Y) de cette vue.
La distance de la caméra du plan de vue peut avoir un impact sur la distorsion de la perspective de la vue lorsqu’elle est pivotée autour de l’axe x ou y. Par exemple, une grande distance entraîne un grand angle d’affichage, et il n’y aura pas beaucoup de distorsion de perspective de la vue lors de sa rotation. Une courte distance peut entraîner une distorsion de perspective beaucoup plus importante lors de la rotation, et peut également entraîner des artefacts de dessin si la vue pivotée se termine partiellement derrière la caméra (c’est pourquoi la recommandation consiste à utiliser une distance au moins jusqu’à la taille de la vue, si la vue doit être pivotée.)
La distance est exprimée en « pixels de profondeur ». La distance par défaut dépend de la densité de l’écran. Par exemple, sur un affichage de densité moyenne, la distance par défaut est 1280. Sur un affichage à haute densité, la distance par défaut est 1920.
Si vous souhaitez spécifier une distance qui conduit à des résultats visuellement cohérents entre différentes densités, utilisez la formule suivante :
float scale = context.getResources().getDisplayMetrics().density;
view.setCameraDistance(distance * scale);
Le facteur d’échelle de densité d’un affichage à haute densité est de 1,5 et 1920 = 1280 * 1,5.
Java documentation pour android.view.View.setCameraDistance(float).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.