BitmapEncoder.CreateForInPlacePropertyEncodingAsync(BitmapDecoder) Método
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í.
Crea de forma asincrónica un nuevo BitmapEncoder para la edición de metadatos y propiedades en contexto. El nuevo codificador solo puede editar las propiedades del mapa de bits en contexto y producirá un error en cualquier otro uso.
public:
static IAsyncOperation<BitmapEncoder ^> ^ CreateForInPlacePropertyEncodingAsync(BitmapDecoder ^ bitmapDecoder);/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder const& bitmapDecoder);[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder bitmapDecoder);function createForInPlacePropertyEncodingAsync(bitmapDecoder)Public Shared Function CreateForInPlacePropertyEncodingAsync (bitmapDecoder As BitmapDecoder) As IAsyncOperation(Of BitmapEncoder)Parámetros
- bitmapDecoder
- BitmapDecoder
BitmapDecoder que contiene los datos de imagen que se van a editar. Este parámetro debe crearse en una secuencia con un modo de acceso de ReadWrite.
Nota:
El codificador escribe en la secuencia en la que se creó el bitmapDecoder original. No se puede especificar un flujo de salida.
Devoluciones
Objeto que administra la inicialización asincrónica de un nuevo BitmapEncoder mediante datos de un bitmapDecoder existente.
- Atributos
Comentarios
Use este método para recuperar un codificador cuando solo vaya a usarlo para editar o escribir una cantidad limitada de propiedades en la imagen. Un codificador recuperado de esta manera puede proporcionar una ventaja de rendimiento sobre un codificador devuelto por CreateForTranscodingAsync porque escribe las nuevas propiedades en espacio de relleno vacío en lugar de volver a codificar toda la imagen.
Estas son varias limitaciones para un codificador recuperado de esta manera:
- Solo puede usar estos métodos en el codificador:
- BitmapEncoder.BitmapProperties.GetPropertiesAsync
- BitmapEncoder.BitmapProperties.SetPropertiesAsync
- BitmapEncoder.FlushAsync Cualquier otro método producirá un error si los llama.
- BitmapDecoder de entrada debe ser un codificador creado en una secuencia con acceso ReadWrite.
- No todos los formatos de metadatos admiten codificación rápida de metadatos. Los controladores de metadatos nativos que admiten metadatos son IFD, Exif, XMP y GPS.
- El bloque de metadatos debe tener suficiente relleno para almacenar las propiedades que está intentando editar.
Si se produce un error en una operación de codificación por cualquier motivo, tendrá que usar CreateForTranscodingAsync para editar los metadatos y volver a codificar la imagen. Al volver a codificar, también puede agregar relleno nuevo o adicional para habilitar la codificación de propiedades en contexto en el futuro. Para ello, cree un bitmapTypedValue con type establecido en UInt32 y Value establecido en el número de bytes de relleno que desea agregar. Un valor típico es de 4096 bytes. Establezca este elemento de metadatos en una o varias de las ubicaciones de consulta de metadatos de esta tabla.
Formato de metadatos Consulta de metadatos JPEG Consulta de metadatos de TIFF, JPEG-XR IFD /app1/ifd/PaddingSchema:Padding /ifd/PaddingSchema:Padding EXIF /app1/ifd/exif/PaddingSchema:Padding /ifd/exif/PaddingSchema:Padding XMP /xmp/PaddingSchema:Padding /ifd/xmp/PaddingSchema:Padding GPS /app1/ifd/gps/PaddingSchema:Padding /ifd/gps/PaddingSchema:Padding Se aplica a