BitmapFactory.Options.InBitmap Propriété
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.
Si elle est définie, les méthodes de décodage qui prennent l’objet Options tentent de réutiliser cette bitmap lors du chargement du contenu.
[Android.Runtime.Register("inBitmap")]
public Android.Graphics.Bitmap InBitmap { get; set; }[<Android.Runtime.Register("inBitmap")>]
member this.InBitmap : Android.Graphics.Bitmap with get, setValeur de propriété
- Attributs
Remarques
Si elle est définie, les méthodes de décodage qui prennent l’objet Options tentent de réutiliser cette bitmap lors du chargement du contenu. Si l’opération de décodage ne peut pas utiliser cette bitmap, la méthode de décodage lève un java.lang.IllegalArgumentException. L’implémentation actuelle nécessite que la bitmap réutilisée soit mutable et que la bitmap réutilisée résultante continue de rester mutable même lorsque le décodage d’une ressource qui entraînerait normalement une image bitmap immuable.</p>
Vous devez toujours utiliser la bitmap retournée de la méthode de décodage et ne pas supposer que la réutilisation de la bitmap a fonctionné, en raison des contraintes décrites ci-dessus et des situations d’échec qui peuvent se produire. La vérification de la valeur de retour correspond à la valeur du jeu inBitmap dans la structure Options indique si la bitmap a été réutilisée, mais dans tous les cas, vous devez utiliser la bitmap retournée par la fonction de décodage pour vous assurer que vous utilisez la bitmap utilisée comme destination de décodage.
<Utilisation de h3>avec BitmapFactory</h3>
À compter de android.os.Build.VERSION_CODES#KITKAT, toute bitmap mutable peut être réutilisée BitmapFactory pour décoder toutes les autres bitmaps tant que le résultat Bitmap#getByteCount() byte count de la bitmap décodée est inférieur ou égal à la Bitmap#getAllocationByteCount() allocated byte count bitmap réutilisée. Cela peut être dû au fait que la taille intrinsèque est plus petite ou que sa taille post-mise à l’échelle (pour la densité/ la taille de l’échantillon) est plus petite.
<p class="remarque">Avant android.os.Build.VERSION_CODES#KITKAT les contraintes supplémentaires s’appliquent : l’image en cours de décodage (qu’il s’agisse d’une ressource ou d’un flux) doit être au format jpeg ou png. Seules les bitmaps de taille égale sont prises en charge, avec #inSampleSize la valeur 1 définie. En outre, la android.graphics.Bitmap.Config configuration bitmap réutilisée remplace le paramètre de #inPreferredConfig, si elle est définie.</p>
<Utilisation de h3>avec BitmapRegionDecoder</h3>
BitmapRegionDecoder dessine son contenu demandé dans la bitmap fournie, découpage si la taille de contenu de sortie (post-mise à l’échelle) est supérieure à la bitmap fournie. La largeur, la hauteur et Bitmap.Config la hauteur de la bitmap fournies ne seront pas modifiées.
<p class="note">BitmapRegionDecoder support for #inBitmap a été introduit dans android.os.Build.VERSION_CODES#JELLY_BEAN. Tous les formats pris en charge par BitmapRegionDecoder prennent en charge la réutilisation bitmap via #inBitmap.
Documentation Java pour android.graphics.BitmapFactory.Options.inBitmap.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.