/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at https://mozilla.org/MPL/2.0/. */ use std::ops::{Deref, DerefMut}; use euclid::default::Size2D; use ipc_channel::ipc::IpcSharedMemory; use malloc_size_of_derive::MallocSizeOf; use serde::{Deserialize, Serialize}; use crate::{Multiply, transform_inplace}; #[derive(Clone, Copy, Debug, Default, Deserialize, Eq, MallocSizeOf, PartialEq, Serialize)] pub enum SnapshotPixelFormat { #[default] RGBA, BGRA, } #[derive(Clone, Copy, Debug, Deserialize, Eq, MallocSizeOf, PartialEq, Serialize)] pub enum SnapshotAlphaMode { /// Internal data is opaque (alpha is cleared to 1) Opaque, /// Internal data should be threated as opaque (does not mean it actually is) AsOpaque { premultiplied: bool }, /// Data is not opaque Transparent { premultiplied: bool }, } impl Default for SnapshotAlphaMode { fn default() -> Self { Self::Transparent { premultiplied: true, } } } impl SnapshotAlphaMode { pub const fn is_premultiplied(&self) -> bool { match self { SnapshotAlphaMode::Opaque => true, SnapshotAlphaMode::AsOpaque { premultiplied } => *premultiplied, SnapshotAlphaMode::Transparent { premultiplied } => *premultiplied, } } pub const fn is_opaque(&self) -> bool { matches!( self, SnapshotAlphaMode::Opaque | SnapshotAlphaMode::AsOpaque { .. } ) } } #[derive(Clone, Debug, Deserialize, MallocSizeOf, Serialize)] pub enum SnapshotData { // TODO: https://github.com/servo/servo/issues/36594 //IPC(IpcSharedMemory), Owned(Vec), } impl Deref for SnapshotData { type Target = [u8]; fn deref(&self) -> &Self::Target { match &self { //Data::IPC(ipc_shared_memory) => ipc_shared_memory, SnapshotData::Owned(items) => items, } } } impl DerefMut for SnapshotData { fn deref_mut(&mut self) -> &mut Self::Target { match self { //Data::IPC(ipc_shared_memory) => unsafe { ipc_shared_memory.deref_mut() }, SnapshotData::Owned(items) => items, } } } pub type IpcSnapshot = Snapshot; /// Represents image bitmap with metadata, usually as snapshot of canvas /// /// This allows us to hold off conversions (BGRA <-> RGBA, (un)premultiply) /// to when/if they are actually needed (WebGL/WebGPU can load both BGRA and RGBA). /// /// Inspired by snapshot for concept in WebGPU spec: /// #[derive(Clone, Debug, Deserialize, MallocSizeOf, Serialize)] pub struct Snapshot { size: Size2D, /// internal data (can be any format it will be converted on use if needed) data: T, /// RGBA/BGRA (reflect internal data) format: SnapshotPixelFormat, /// How to treat alpha channel alpha_mode: SnapshotAlphaMode, } impl Snapshot { pub const fn size(&self) -> Size2D { self.size } pub const fn format(&self) -> SnapshotPixelFormat { self.format } pub const fn alpha_mode(&self) -> SnapshotAlphaMode { self.alpha_mode } pub const fn is_premultiplied(&self) -> bool { self.alpha_mode().is_premultiplied() } pub const fn is_opaque(&self) -> bool { self.alpha_mode().is_opaque() } } impl Snapshot { pub fn empty() -> Self { Self { size: Size2D::zero(), data: SnapshotData::Owned(vec![]), format: SnapshotPixelFormat::RGBA, alpha_mode: SnapshotAlphaMode::Transparent { premultiplied: true, }, } } /// Returns snapshot with provided size that is black transparent alpha pub fn cleared(size: Size2D) -> Self { Self { size, data: SnapshotData::Owned(vec![0; size.area() as usize * 4]), format: SnapshotPixelFormat::RGBA, alpha_mode: SnapshotAlphaMode::Transparent { premultiplied: true, }, } } pub fn from_vec( size: Size2D, format: SnapshotPixelFormat, alpha_mode: SnapshotAlphaMode, data: Vec, ) -> Self { Self { size, data: SnapshotData::Owned(data), format, alpha_mode, } } // TODO: https://github.com/servo/servo/issues/36594 /* /// # Safety /// /// This is safe if data is owned by this process only /// (ownership is transferred on send) pub unsafe fn from_shared_memory( size: Size2D, format: PixelFormat, alpha_mode: AlphaMode, ism: IpcSharedMemory, ) -> Self { Self { size, data: Data::IPC(ism), format, alpha_mode, } } */ pub fn data(&self) -> &[u8] { &self.data } pub fn data_mut(&mut self) -> &mut [u8] { &mut self.data } /// Convert inner data of snapshot to target format and alpha mode. /// If data is already in target format and alpha mode no work will be done. pub fn transform( &mut self, target_alpha_mode: SnapshotAlphaMode, target_format: SnapshotPixelFormat, ) { let swap_rb = target_format != self.format; let multiply = match (self.alpha_mode, target_alpha_mode) { (SnapshotAlphaMode::Opaque, _) => Multiply::None, (alpha_mode, SnapshotAlphaMode::Opaque) => { if alpha_mode.is_premultiplied() { Multiply::UnMultiply } else { Multiply::None } }, ( SnapshotAlphaMode::Transparent { premultiplied } | SnapshotAlphaMode::AsOpaque { premultiplied }, SnapshotAlphaMode::Transparent { premultiplied: target_premultiplied, } | SnapshotAlphaMode::AsOpaque { premultiplied: target_premultiplied, }, ) => { if premultiplied == target_premultiplied { Multiply::None } else if target_premultiplied { Multiply::PreMultiply } else { Multiply::UnMultiply } }, }; let clear_alpha = !matches!(self.alpha_mode, SnapshotAlphaMode::Opaque) && matches!(target_alpha_mode, SnapshotAlphaMode::Opaque); transform_inplace(self.data.deref_mut(), multiply, swap_rb, clear_alpha); self.alpha_mode = target_alpha_mode; self.format = target_format; } pub fn as_ipc(self) -> Snapshot { let Snapshot { size, data, format, alpha_mode, } = self; let data = match data { //Data::IPC(ipc_shared_memory) => ipc_shared_memory, SnapshotData::Owned(items) => IpcSharedMemory::from_bytes(&items), }; Snapshot { size, data, format, alpha_mode, } } pub fn to_vec(self) -> Vec { match self.data { SnapshotData::Owned(data) => data, } } } impl Snapshot { // TODO: https://github.com/servo/servo/issues/36594 /* /// # Safety /// /// This is safe if data is owned by this process only /// (ownership is transferred on send) pub unsafe fn to_data(self) -> Snapshot { let Snapshot { size, data, format, alpha_mode, } = self; Snapshot { size, data: Data::IPC(data), format, alpha_mode, } } */ pub fn to_owned(self) -> Snapshot { let Snapshot { size, data, format, alpha_mode, } = self; Snapshot { size, data: SnapshotData::Owned(data.to_vec()), format, alpha_mode, } } pub fn data(&self) -> &[u8] { &self.data } pub fn to_ipc_shared_memory(self) -> IpcSharedMemory { self.data } }