Come salvare il contenuto Direct2D in un file di immagine

Articolo
06/12/2023

Questo argomento illustra come usare IWICImageEncoder per salvare il contenuto sotto forma di id2D1Image in un file di immagine codificato, ad esempio JPEG. Se si scrive un'app di Windows Store, è possibile selezionare un file di destinazione usando Windows::Storage::P ickers::FileSavePicker.

Informazioni importanti

Tecnologie

Prerequisiti

È necessario un oggetto ID2D1DeviceContext e un oggetto contenente contenuto Direct2D che implementa ID2D1Image , ad esempio ID2D1Effect o ID2D1Bitmap1.

Istruzioni

Passaggio 1: Ottenere un file di destinazione e un flusso

Se si vuole consentire all'utente di selezionare un file di destinazione, è possibile usare FileSavePicker, aprire il file restituito e ottenere un IStream da usare con WIC.

Creare un oggetto Windows::Storage::P ickers::FileSavePicker e impostarne i parametri per i file di immagine. Chiamare il metodo PickSaveFileAsync .

    Pickers::FileSavePicker^ savePicker = ref new Pickers::FileSavePicker();
    auto jpgExtensions = ref new Platform::Collections::Vector<Platform::String^>();
    pngExtensions->Append(".png");
    savePicker->FileTypeChoices->Insert("PNG file", pngExtensions);
    auto jpgExtensions = ref new Platform::Collections::Vector<Platform::String^>();
    jpgExtensions->Append(".jpg");
    savePicker->FileTypeChoices->Insert("JPEG file", jpgExtensions);
    savePicker->DefaultFileExtension = ".jpg";
    savePicker->SuggestedFileName = "SaveScreen";
    savePicker->SuggestedStartLocation = Pickers::PickerLocationId::PicturesLibrary;

    task<StorageFile^> fileTask(savePicker->PickSaveFileAsync());

Dichiarare un gestore di completamento da eseguire dopo che la selezione file restituisce l'operazione asincrona. Usare il metodo GetResults per recuperare il file e ottenere l'oggetto flusso di file.

    task<StorageFile^> fileTask(savePicker->PickSaveFileAsync());
    fileTask.then([=](StorageFile^ file) {
        if (file != nullptr)
        {
            // User selects a file.
            GUID wicFormat = GUID_ContainerFormatPng;
            if (file->FileType == ".jpg")
            {
                wicFormat = GUID_ContainerFormatJpeg;
            }

Ottenere un IRandomAccessStream chiamando OpenAsync nel file e ottenendo il risultato dell'operazione asincrona.

    task<Streams::IRandomAccessStream^> createStreamTask(file->OpenAsync(FileAccessMode::ReadWrite));
    createStreamTask.then([=](Streams::IRandomAccessStream^ randomAccessStream) {

Infine, usare il metodo CreateStreamOverRandomAccessStream per convertire il flusso di file. Windows Runtime API rappresentano flussi con IRandomAccessStream, mentre WIC usa IStream.

    ComPtr<IStream> stream;
    DX::ThrowIfFailed(
        CreateStreamOverRandomAccessStream(randomAccessStream, IID_PPV_ARGS(&stream))
        );

Nota

Per usare la funzione CreateStreamOverRandomAccessStream , è necessario includere shcore.h nel progetto.

Passaggio 2: Ottenere il codificatore bitmap e frame WIC

IWICBitmapEncoder e IWICBitmapFrameEncode forniscono la funzionalità per salvare i dati di immagine in un formato di file codificato.

Creare e inizializzare gli oggetti codificatori.

    ComPtr<IWICBitmapEncoder> wicBitmapEncoder;
    DX::ThrowIfFailed(
        wicFactory2->CreateEncoder(
            wicFormat,
            nullptr,    // No preferred codec vendor.
            &wicBitmapEncoder
            )
        );

    DX::ThrowIfFailed(
        wicBitmapEncoder->Initialize(
            stream,
            WICBitmapEncoderNoCache
            )
        );

    ComPtr<IWICBitmapFrameEncode> wicFrameEncode;
    DX::ThrowIfFailed(
        wicBitmapEncoder->CreateNewFrame(
            &wicFrameEncode,
            nullptr     // No encoder options.
            )
        );

    DX::ThrowIfFailed(
        wicFrameEncode->Initialize(nullptr)
        );

Passaggio 3: Ottenere un IWICImageEncoder

IWICImageEncoder è una nuova interfaccia in Windows 8. Può essere creato da IWICImagingFactory2, che estende IWICImagingFactory ed è anche nuovo per Windows 8.

ComPtr<IWICImagingFactory2> m_wicFactory;

DX::ThrowIfFailed(
    CoCreateInstance(
        CLSID_WICImagingFactory,
        nullptr,
        CLSCTX_INPROC_SERVER,
        IID_PPV_ARGS(&m_wicFactory)
        )
    );

Chiamare IWICImagingFactory2::CreateImageEncoder. Il primo parametro è un ID2D1Device e deve essere il dispositivo in cui è stata creata l'immagine da codificare. Non è possibile combinare immagini da domini di risorse diversi all'interno di un singolo IWICImageEncoder.

    ComPtr<IWICImageEncoder> imageEncoder;
    DX::ThrowIfFailed(
        wicFactory2->CreateImageEncoder(
            d2dDevice.Get(),
            &imageEncoder
            )
       );

Passaggio 4: Scrivere il contenuto Direct2D usando IWICImageEncoder

IWICImageEncoder può scrivere un'immagine Direct2D in un frame di immagini, un'anteprima di cornice o l'anteprima del contenitore. È quindi possibile usare IWICBitmapEncoder e IWICBitmapFrameEncode per codificare i dati di immagine in un file come normale.

Scrivere l'immagine Direct2D nella cornice. In questo frammento di codice viene scritto un ID2D1Bitmap contenente contenuto Direct2D rasterizzato. È tuttavia possibile fornire qualsiasi interfaccia che implementa ID2D1Image.

    DX::ThrowIfFailed(
        imageEncoder->WriteFrame(
            d2dBitmap.Get(),
            wicFrameEncode.Get(),
            nullptr     // Use default WICImageParameter options.
            )
        );

Nota

Il parametro ID2D1Image deve essere stato creato nel dispositivo ID2D1Device passato a IWICImagingFactory2::CreateImageEncoder.

Eseguire il commit delle risorse WIC e di flusso per finalizzare l'operazione.

    DX::ThrowIfFailed(
        wicFrameEncode->Commit()
        );

    DX::ThrowIfFailed(
        wicBitmapEncoder->Commit()
        );

    // Flush all memory buffers to the next-level storage object.
    DX::ThrowIfFailed(
        stream->Commit(STGC_DEFAULT)
        );

Nota

Alcune implementazioni di IStream non implementano il metodo Commit e restituiscono E_NOTIMPL.

A questo momento è disponibile un file contenente l'immagine Direct2D .

Esempio completo

Qui il codice completo per questo esempio.

ComPtr<IWICImagingFactory2> m_wicFactory;

DX::ThrowIfFailed(
    CoCreateInstance(
        CLSID_WICImagingFactory,
        nullptr,
        CLSCTX_INPROC_SERVER,
        IID_PPV_ARGS(&m_wicFactory)
        )
    );

void SaveAsImageFile::SaveBitmapToFile()
{
    // Prepare a file picker for customers to input image file name.
    Pickers::FileSavePicker^ savePicker = ref new Pickers::FileSavePicker();
    auto pngExtensions = ref new Platform::Collections::Vector<Platform::String^>();
    pngExtensions->Append(".png");
    savePicker->FileTypeChoices->Insert("PNG file", pngExtensions);
    auto jpgExtensions = ref new Platform::Collections::Vector<Platform::String^>();
    jpgExtensions->Append(".jpg");
    savePicker->FileTypeChoices->Insert("JPEG file", jpgExtensions);
    auto bmpExtensions = ref new Platform::Collections::Vector<Platform::String^>();
    bmpExtensions->Append(".bmp");
    savePicker->FileTypeChoices->Insert("BMP file", bmpExtensions);
    savePicker->DefaultFileExtension = ".png";
    savePicker->SuggestedFileName = "SaveScreen";
    savePicker->SuggestedStartLocation = Pickers::PickerLocationId::PicturesLibrary;

    task<StorageFile^> fileTask(savePicker->PickSaveFileAsync());
    fileTask.then([=](StorageFile^ file) {
        if (file != nullptr)
        {
            // User selects a file.
            m_imageFileName = file->Name;
            GUID wicFormat = GUID_ContainerFormatPng;
            if (file->FileType == ".bmp")
            {
                wicFormat = GUID_ContainerFormatBmp;
            }
            else if (file->FileType == ".jpg")
            {
                wicFormat = GUID_ContainerFormatJpeg;
            }

            // Retrieve a stream from the file.
            task<Streams::IRandomAccessStream^> createStreamTask(file->OpenAsync(FileAccessMode::ReadWrite));
            createStreamTask.then([=](Streams::IRandomAccessStream^ randomAccessStream) {
                // Convert the RandomAccessStream to an IStream.
                ComPtr<IStream> stream;
                DX::ThrowIfFailed(
                    CreateStreamOverRandomAccessStream(randomAccessStream, IID_PPV_ARGS(&stream))
                    );

                SaveBitmapToStream(m_d2dTargetBitmap, m_wicFactory, m_d2dContext, wicFormat, stream.Get());
            });
        }
    });
}

// Save render target bitmap to a stream using WIC.
void SaveAsImageFile::SaveBitmapToStream(
    _In_ ComPtr<ID2D1Bitmap1> d2dBitmap,
    _In_ ComPtr<IWICImagingFactory2> wicFactory2,
    _In_ ComPtr<ID2D1DeviceContext> d2dContext,
    _In_ REFGUID wicFormat,
    _In_ IStream* stream
    )
{
    // Create and initialize WIC Bitmap Encoder.
    ComPtr<IWICBitmapEncoder> wicBitmapEncoder;
    DX::ThrowIfFailed(
        wicFactory2->CreateEncoder(
            wicFormat,
            nullptr,    // No preferred codec vendor.
            &wicBitmapEncoder
            )
        );

    DX::ThrowIfFailed(
        wicBitmapEncoder->Initialize(
            stream,
            WICBitmapEncoderNoCache
            )
        );

    // Create and initialize WIC Frame Encoder.
    ComPtr<IWICBitmapFrameEncode> wicFrameEncode;
    DX::ThrowIfFailed(
        wicBitmapEncoder->CreateNewFrame(
            &wicFrameEncode,
            nullptr     // No encoder options.
            )
        );

    DX::ThrowIfFailed(
        wicFrameEncode->Initialize(nullptr)
        );

    // Retrieve D2D Device.
    ComPtr<ID2D1Device> d2dDevice;
    d2dContext->GetDevice(&d2dDevice);

    // Create IWICImageEncoder.
    ComPtr<IWICImageEncoder> imageEncoder;
    DX::ThrowIfFailed(
        wicFactory2->CreateImageEncoder(
            d2dDevice.Get(),
            &imageEncoder
            )
       );

    DX::ThrowIfFailed(
        imageEncoder->WriteFrame(
            d2dBitmap.Get(),
            wicFrameEncode.Get(),
            nullptr     // Use default WICImageParameter options.
            )
        );

    DX::ThrowIfFailed(
        wicFrameEncode->Commit()
        );

    DX::ThrowIfFailed(
        wicBitmapEncoder->Commit()
        );

    // Flush all memory buffers to the next-level storage object.
    DX::ThrowIfFailed(
        stream->Commit(STGC_DEFAULT)
        );
}

Condividi tramite

Come salvare il contenuto Direct2D in un file di immagine

Informazioni importanti

Tecnologie

Prerequisiti

Istruzioni

Passaggio 1: Ottenere un file di destinazione e un flusso

Passaggio 2: Ottenere il codificatore bitmap e frame WIC

Passaggio 3: Ottenere un IWICImageEncoder

Passaggio 4: Scrivere il contenuto Direct2D usando IWICImageEncoder

Esempio completo

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive