BitmapFactory.Options.InBitmap Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Si se establece, descodificar métodos que toman el objeto Options intentará reutilizar este mapa de bits al cargar contenido.
[Android.Runtime.Register("inBitmap")]
public Android.Graphics.Bitmap InBitmap { get; set; }
[<Android.Runtime.Register("inBitmap")>]
member this.InBitmap : Android.Graphics.Bitmap with get, set
Valor de propiedad
- Atributos
Comentarios
Si se establece, descodificar métodos que toman el objeto Options intentará reutilizar este mapa de bits al cargar contenido. Si la operación de descodificación no puede usar este mapa de bits, el método de descodificación producirá una java.lang.IllegalArgumentException
excepción . La implementación actual requiere que el mapa de bits reutilizado sea mutable y el mapa de bits reutilizado resultante seguirá siendo mutable incluso cuando se descodice un recurso que normalmente daría como resultado un mapa de bits inmutable.</p>
Debe seguir usando siempre el mapa de bits devuelto del método de descodificación y no asumir que la reutilización del mapa de bits funcionó, debido a las restricciones descritas anteriormente y las situaciones de error que pueden producirse. Comprobar si el valor devuelto coincide con el valor del conjunto inBitmap en la estructura Options indicará si el mapa de bits se ha reutilizado, pero en todos los casos debe usar el mapa de bits devuelto por la función de descodificación para asegurarse de que está usando el mapa de bits que se usó como destino de descodificación.
<h3>Uso con BitmapFactory</h3>
A partir de android.os.Build.VERSION_CODES#KITKAT
, cualquier mapa de bits mutable se puede reutilizar para BitmapFactory
descodificar cualquier otro mapa de bits siempre que el resultado Bitmap#getByteCount() byte count
del mapa de bits descodificado sea menor o igual que el Bitmap#getAllocationByteCount() allocated byte count
del mapa de bits reutilizado. Esto puede deberse a que el tamaño intrínseco es menor o su tamaño posterior al escalado (para densidad o tamaño de muestra) es menor.
<p class="note">Antes de android.os.Build.VERSION_CODES#KITKAT
aplicar restricciones adicionales: la imagen que se descodifica (ya sea como un recurso o como secuencia) debe estar en formato jpeg o png. Solo se admiten mapas de bits de tamaño igual, con #inSampleSize
establecido en 1. Además, el android.graphics.Bitmap.Config configuration
del mapa de bits reutilizado invalidará la configuración de #inPreferredConfig
, si se establece.</p>
<h3>Uso con BitmapRegionDecoder</h3>
BitmapRegionDecoder dibujará su contenido solicitado en el mapa de bits proporcionado, recortando si el tamaño de contenido de salida (escala posterior) es mayor que el mapa de bits proporcionado. El ancho, el alto y Bitmap.Config
el ancho del mapa de bits proporcionados no se cambiarán.
<p class="note">BitmapRegionDecoder support for #inBitmap
was introduced in android.os.Build.VERSION_CODES#JELLY_BEAN
. Todos los formatos admitidos por BitmapRegionDecoder admiten la reutilización del mapa de bits mediante #inBitmap
.
Documentación de Java para android.graphics.BitmapFactory.Options.inBitmap
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.