BitmapEncoder Classe

Definizione

public ref class BitmapEncoder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BitmapEncoder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BitmapEncoder

Public NotInheritable Class BitmapEncoder

Ereditarietà

Object Platform::Object IInspectable BitmapEncoder

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Esempio

Ecco un esempio parziale di creazione di un oggetto codificatore. In questo esempio si presuppone che sia stato selezionato un file con Windows.Storage.Pickers.FileSavePicker. Per istruzioni complete sulla selezione di un file, sulla creazione di un codificatore e sulla codifica di un'immagine, vedere Creazione di immagini

private async void SaveSoftwareBitmapToFile(SoftwareBitmap softwareBitmap, StorageFile outputFile)
{
    using (IRandomAccessStream stream = await outputFile.OpenAsync(FileAccessMode.ReadWrite))
    {
        // Create an encoder with the desired format
        BitmapEncoder encoder = await BitmapEncoder.CreateAsync(BitmapEncoder.JpegEncoderId, stream);

        // Set the software bitmap
        encoder.SetSoftwareBitmap(softwareBitmap);

        // Set additional encoding parameters, if needed
        encoder.BitmapTransform.ScaledWidth = 320;
        encoder.BitmapTransform.ScaledHeight = 240;
        encoder.BitmapTransform.Rotation = Windows.Graphics.Imaging.BitmapRotation.Clockwise90Degrees;
        encoder.BitmapTransform.InterpolationMode = BitmapInterpolationMode.Fant;
        encoder.IsThumbnailGenerated = true;

        try
        {
            await encoder.FlushAsync();
        }
        catch (Exception err)
        {
            const int WINCODEC_ERR_UNSUPPORTEDOPERATION = unchecked((int)0x88982F81);
            switch (err.HResult)
            {
                case WINCODEC_ERR_UNSUPPORTEDOPERATION: 
                    // If the encoder does not support writing a thumbnail, then try again
                    // but disable thumbnail generation.
                    encoder.IsThumbnailGenerated = false;
                    break;
                default:
                    throw;
            }
        }

        if (encoder.IsThumbnailGenerated == false)
        {
            await encoder.FlushAsync();
        }


    }
}

Commenti

Formati di immagine

BitmapEncoder può codificare i formati seguenti.

• JPEG
• PNG
• GIF
• TIFF
• BMP
• JPEG-XR

Per un elenco dei formati di decodifica, vedere l'argomento BitmapDecoder .

BitmapEncoder si comporta in modo diverso da BitmapDecoder in quanto non fornisce l'accesso casuale ai fotogrammi in un'immagine. È invece necessario eseguire azioni sul codificatore in un ordine specifico.

Quando si crea un bitmapEncoder, fornisce l'accesso ai dati nel contenitore e al primo fotogramma. Al termine dell'impostazione dei dati nel primo frame e nel contenitore, se non si vogliono codificare fotogrammi aggiuntivi, chiamare FlushAsync per completare l'operazione di codifica.

Per codificare un frame aggiuntivo, chiamare GoToNextFrameAsync. In questo modo i dati vengono confermati nel contenitore e nel primo frame, in modo da non poterli modificare più. A questo punto, tutte le azioni eseguite sul codificatore avranno effetto sul secondo fotogramma. Al termine di ogni fotogramma, è possibile chiamare GoToNextFrameAsync per eseguire il commit e accodare un nuovo frame oppure chiamare FlushAsync per terminare. I codificatori bitmap possono esporre varie opzioni di codifica che influiscono sulla qualità, le dimensioni e altre proprietà del file di output codificato. Per altre info, vedi Imaging.

Cronologia delle versioni

Proprietà

Metodi

Si applica a

Vedi anche

• Creazione delle immagini
• Esempio di risoluzione della fotocamera (Windows 10)
• Esempio di app della fotocamera di base (Windows 10)
• Esempio di stabilizzazione video (Windows 10)
• Esempio di rilevamento viso della fotocamera (Windows 10)
• Esempio di controlli della fotocamera manuale (Windows 10)
• Esempio di intervallo dinamico elevato (Windows 10)
• Esempio di acquisizione avanzata della fotocamera