Cara menyimpan konten Direct2D ke file gambar
Topik ini menunjukkan cara menggunakan IWICImageEncoder untuk menyimpan konten dalam bentuk ID2D1Image ke file gambar yang dikodekan seperti JPEG. Jika Anda menulis aplikasi Windows Store, Anda dapat meminta pengguna memilih file tujuan menggunakan Windows::Storage::P ickers::FileSavePicker.
Apa yang perlu Anda ketahui
Teknologi
Prasyarat
- Anda memerlukan objek ID2D1DeviceContext dan objek yang berisi konten Direct2D yang mengimplementasikan ID2D1Image seperti ID2D1Effect atau ID2D1Bitmap1.
Petunjuk
Langkah 1: Mendapatkan file dan streaming tujuan
Jika Anda ingin mengizinkan pengguna untuk memilih file tujuan, Anda dapat menggunakan FileSavePicker, membuka file yang dikembalikan, dan mendapatkan IStream untuk digunakan dengan WIC.
Buat Windows::Storage::P ickers::FileSavePicker dan atur parameternya untuk file gambar. Panggil metode 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());
Nyatakan handler penyelesaian untuk dijalankan setelah operasi asinkron pemilih file kembali. Gunakan metode GetResults untuk mengambil file dan untuk mendapatkan objek aliran 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;
}
Dapatkan IRandomAccessStream dengan memanggil OpenAsync pada file dan mendapatkan hasil dari operasi asinkron.
task<Streams::IRandomAccessStream^> createStreamTask(file->OpenAsync(FileAccessMode::ReadWrite));
createStreamTask.then([=](Streams::IRandomAccessStream^ randomAccessStream) {
Terakhir, gunakan metode CreateStreamOverRandomAccessStream untuk mengonversi aliran file. API Runtime Windows mewakili aliran dengan IRandomAccessStream, sementara WIC mengonsumsi IStream.
ComPtr<IStream> stream;
DX::ThrowIfFailed(
CreateStreamOverRandomAccessStream(randomAccessStream, IID_PPV_ARGS(&stream))
);
Catatan
Untuk menggunakan fungsi CreateStreamOverRandomAccessStream , Anda harus menyertakan shcore.h dalam proyek Anda.
Langkah 2: Dapatkan bitmap WIC dan encoder bingkai
IWICBitmapEncoder dan IWICBitmapFrameEncode menyediakan fungsionalitas untuk menyimpan data pencitraan ke format file yang dikodekan.
Membuat dan menginisialisasi objek encoder.
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)
);
Langkah 3: Dapatkan IWICImageEncoder
IWICImageEncoder adalah antarmuka baru dalam Windows 8. Ini dapat dibuat dari IWICImagingFactory2, yang memperluas IWICImagingFactory dan juga baru untuk Windows 8.
ComPtr<IWICImagingFactory2> m_wicFactory;
DX::ThrowIfFailed(
CoCreateInstance(
CLSID_WICImagingFactory,
nullptr,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&m_wicFactory)
)
);
Panggil IWICImagingFactory2::CreateImageEncoder. Parameter pertama adalah ID2D1Device dan harus menjadi perangkat tempat gambar yang ingin Anda kodekan dibuat - Anda tidak dapat mencampur gambar dari domain sumber daya yang berbeda dalam satu IWICImageEncoder.
ComPtr<IWICImageEncoder> imageEncoder;
DX::ThrowIfFailed(
wicFactory2->CreateImageEncoder(
d2dDevice.Get(),
&imageEncoder
)
);
Langkah 4: Tulis konten Direct2D menggunakan IWICImageEncoder
IWICImageEncoder dapat menulis gambar Direct2D ke dalam bingkai gambar, gambar mini bingkai, atau gambar mini kontainer. Anda kemudian dapat menggunakan IWICBitmapEncoder dan IWICBitmapFrameEncode untuk mengodekan data pencitraan ke file seperti biasa.
Tulis gambar Direct2D ke bingkai. Dalam cuplikan ini kami menulis ID2D1Bitmap yang berisi konten Direct2D yang dirasterisasi. Namun, Anda dapat menyediakan antarmuka apa pun yang mengimplementasikan ID2D1Image.
DX::ThrowIfFailed(
imageEncoder->WriteFrame(
d2dBitmap.Get(),
wicFrameEncode.Get(),
nullptr // Use default WICImageParameter options.
)
);
Catatan
Parameter ID2D1Image harus dibuat pada ID2D1Device yang diteruskan ke IWICImagingFactory2::CreateImageEncoder.
Terapkan WIC dan streaming sumber daya untuk menyelesaikan operasi.
DX::ThrowIfFailed(
wicFrameEncode->Commit()
);
DX::ThrowIfFailed(
wicBitmapEncoder->Commit()
);
// Flush all memory buffers to the next-level storage object.
DX::ThrowIfFailed(
stream->Commit(STGC_DEFAULT)
);
Catatan
Beberapa implementasi IStream tidak menerapkan metode Penerapan dan mengembalikan E_NOTIMPL.
Sekarang Anda memiliki file yang berisi gambar Direct2D .
Contoh lengkap
Di sini kode lengkap untuk contoh ini.
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)
);
}
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk