Files
nexus/rust/vendor/ironrdp-session/src/image.rs
T
Andy Dixon 50c0104d57 feat(core): RDP client on IronRDP
clients::rdp connects over any caller-dialled TCP stream (direct, proxy
or SSH tunnel), upgrades to TLS and logs on with NLA (CredSSP/NTLM),
optionally falling back to TLS-only logon for servers without NLA such
as xrdp (credentials are passed so they log straight in). The server
certificate is pinned through a caller check on its SHA256 fingerprint
before any credentials are sent. The desktop decodes into the VNC
client's RGBA framebuffer; input (IronRDP's scancode/Unicode/mouse
operations), Display Control resizes and the deactivation-reactivation
sequence run on the session thread.

IronRDP's releases need three vendored patches (vendor/README.md):
picky and sspi with their RustCrypto release-candidate pins relaxed so
they share russh's stable versions (their own suites, 402 tests, pass
against them), and ironrdp-session with two unreleased upstream bitmap
fixes (#1486 stride, #1524 RDP6 orientation) without which xrdp desktops
render sheared.

Verified live against xrdp (scottyhardy/docker-remote-desktop): logon,
full desktop rendering, keyboard and mouse input.
2026-10-12 10:50:24 +01:00

1039 lines
37 KiB
Rust

use std::sync::Arc;
use ironrdp_core::assert_impl;
use ironrdp_graphics::color_conversion::{rdp_15bit_to_rgb, rdp_16bit_to_rgb};
use ironrdp_graphics::image_processing::{ImageRegion, ImageRegionMut, PixelFormat};
use ironrdp_graphics::pointer::DecodedPointer;
use ironrdp_graphics::rectangle_processing::Region;
use ironrdp_pdu::geometry::{InclusiveRectangle, Rectangle as _};
use tracing::{debug, trace};
use crate::{SessionResult, custom_err};
const TILE_SIZE: u16 = 64;
pub struct DecodedImage {
pixel_format: PixelFormat,
data: Vec<u8>,
/// Part of the pointer image which should be drawn
pointer_src_rect: InclusiveRectangle,
/// X position of the pointer sprite on the screen
pointer_draw_x: u16,
/// Y position of the pointer sprite on the screen
pointer_draw_y: u16,
pointer_x: u16,
pointer_y: u16,
pointer: Option<Arc<DecodedPointer>>,
/// Image data, overridden by pointer. Used to restore image after pointer was hidden or moved
pointer_backbuffer: Vec<u8>,
/// Whether to show pointer or not
show_pointer: bool,
/// Whether pointer is visible on the screen or its sprite is currently out of bounds
pointer_visible_on_screen: bool,
width: u16,
height: u16,
}
assert_impl!(DecodedImage: Send);
impl core::fmt::Debug for DecodedImage {
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
f.debug_struct("DecodedImage")
.field("pixel_format", &self.pixel_format)
.field("data_len", &self.data.len())
.field("pointer_src_rect", &self.pointer_src_rect)
.field("pointer_draw_x", &self.pointer_draw_x)
.field("pointer_draw_y", &self.pointer_draw_y)
.field("pointer_x", &self.pointer_x)
.field("pointer_y", &self.pointer_y)
.field("pointer", &self.pointer)
.field("pointer_backbuffer", &self.pointer_backbuffer)
.field("show_pointer", &self.show_pointer)
.field("pointer_visible_on_screen", &self.pointer_visible_on_screen)
.field("width", &self.width)
.field("height", &self.height)
.finish()
}
}
#[derive(PartialEq, Eq)]
enum PointerLayer {
Background,
Pointer,
}
struct PointerRenderingState {
redraw: bool,
update_rectangle: InclusiveRectangle,
}
#[expect(clippy::too_many_arguments)]
fn copy_cursor_data(
from: &[u8],
from_pos: (usize, usize),
from_stride: usize,
to: &mut [u8],
to_stride: usize,
to_pos: (usize, usize),
size: (usize, usize),
dst_size: (usize, usize),
composite: bool,
) {
const PIXEL_SIZE: usize = 4;
if to_pos.0 + size.0 > dst_size.0 || to_pos.1 + size.1 > dst_size.1 {
// Perform clipping
return;
}
let (from_x, from_y) = from_pos;
let (to_x, to_y) = to_pos;
let (width, height) = size;
for y in 0..height {
let from_start = (from_y + y) * from_stride + from_x * PIXEL_SIZE;
let to_start = (to_y + y) * to_stride + to_x * PIXEL_SIZE;
if composite {
for pixel in 0..width {
let dest_r = to[to_start + pixel * PIXEL_SIZE];
let dest_g = to[to_start + pixel * PIXEL_SIZE + 1];
let dest_b = to[to_start + pixel * PIXEL_SIZE + 2];
let src_r = from[from_start + pixel * PIXEL_SIZE];
let src_g = from[from_start + pixel * PIXEL_SIZE + 1];
let src_b = from[from_start + pixel * PIXEL_SIZE + 2];
let src_a = from[from_start + pixel * PIXEL_SIZE + 3];
// Inverted pixel, this color has a special meaning when encoded by ironrdp-graphics
if src_a == 0 && src_r == 255 && src_g == 255 && src_b == 255 {
to[to_start + pixel * PIXEL_SIZE] = 255 - dest_r;
to[to_start + pixel * PIXEL_SIZE + 1] = 255 - dest_g;
to[to_start + pixel * PIXEL_SIZE + 2] = 255 - dest_b;
to[to_start + pixel * PIXEL_SIZE + 3] = 255;
continue;
}
// Skip 100% transparent pixels
if src_a == 0 {
continue;
}
#[expect(clippy::as_conversions, reason = "(u16 >> 8) fits into u8 + hot loop")]
{
// Integer alpha blending, source represented as premultiplied alpha color, calculation in floating point
to[to_start + pixel * PIXEL_SIZE] =
src_r + ((u16::from(dest_r) * u16::from(255 - src_a)) >> 8) as u8;
to[to_start + pixel * PIXEL_SIZE + 1] =
src_g + ((u16::from(dest_g) * u16::from(255 - src_a)) >> 8) as u8;
to[to_start + pixel * PIXEL_SIZE + 2] =
src_b + ((u16::from(dest_b) * u16::from(255 - src_a)) >> 8) as u8;
// Framebuffer is always opaque, so we can skip alpha channel change
}
}
} else {
to[to_start..to_start + width * PIXEL_SIZE]
.copy_from_slice(&from[from_start..from_start + width * PIXEL_SIZE]);
}
}
}
impl DecodedImage {
pub fn new(pixel_format: PixelFormat, width: u16, height: u16) -> Self {
let len = usize::from(width) * usize::from(height) * usize::from(pixel_format.bytes_per_pixel());
Self {
pixel_format,
data: vec![0; len],
width,
height,
pointer_src_rect: InclusiveRectangle {
left: 0,
top: 0,
right: 0,
bottom: 0,
},
pointer_x: 0,
pointer_y: 0,
pointer_draw_x: 0,
pointer_draw_y: 0,
pointer_backbuffer: Vec::new(),
pointer: None,
show_pointer: false,
pointer_visible_on_screen: true,
}
}
pub fn pixel_format(&self) -> PixelFormat {
self.pixel_format
}
pub fn data(&self) -> &[u8] {
&self.data
}
pub fn width(&self) -> u16 {
self.width
}
pub fn bytes_per_pixel(&self) -> usize {
usize::from(self.pixel_format.bytes_per_pixel())
}
pub fn stride(&self) -> usize {
usize::from(self.width) * self.bytes_per_pixel()
}
pub fn data_for_rect(&self, rect: &InclusiveRectangle) -> &[u8] {
let start = usize::from(rect.left) * self.bytes_per_pixel() + usize::from(rect.top) * self.stride();
let end =
start + usize::from(rect.height() - 1) * self.stride() + usize::from(rect.width()) * self.bytes_per_pixel();
&self.data[start..end]
}
pub fn height(&self) -> u16 {
self.height
}
/// Returns `true` if the rectangle fits entirely within the image bounds.
fn rect_fits(&self, rect: &InclusiveRectangle) -> bool {
rect.right < self.width && rect.bottom < self.height
}
fn apply_pointer_layer(&mut self, layer: PointerLayer) -> SessionResult<Option<InclusiveRectangle>> {
// Pointer is not hidden, but its texture is not visible on the screen, so we don't
// need to render it
if layer == PointerLayer::Pointer && !self.pointer_visible_on_screen {
return Ok(None);
}
if self.data.is_empty() {
return Ok(None);
}
let pointer = if let Some(pointer) = &self.pointer {
pointer
} else {
return Ok(None);
};
if self.pointer_src_rect.width() == 0 || self.pointer_src_rect.height() == 0 {
return Ok(None);
}
let dest_rect = InclusiveRectangle {
left: self.pointer_draw_x,
top: self.pointer_draw_y,
right: self.pointer_draw_x + self.pointer_src_rect.width() - 1,
bottom: self.pointer_draw_y + self.pointer_src_rect.height() - 1,
};
if dest_rect.width() == 0 || dest_rect.height() == 0 {
return Ok(None);
}
let pointer_src_rect_width = usize::from(self.pointer_src_rect.width());
let pointer_src_rect_height = usize::from(self.pointer_src_rect.height());
let pointer_draw_x = usize::from(self.pointer_draw_x);
let pointer_draw_y = usize::from(self.pointer_draw_y);
let width = usize::from(self.width);
let height = usize::from(self.height);
match &layer {
PointerLayer::Background => {
if self.pointer_backbuffer.is_empty() {
// Backbuffer were previously empty
return Ok(None);
}
copy_cursor_data(
&self.pointer_backbuffer,
(0, 0),
pointer_src_rect_width * 4,
&mut self.data,
width * 4,
(pointer_draw_x, pointer_draw_y),
(pointer_src_rect_width, pointer_src_rect_height),
(width, height),
false,
);
}
PointerLayer::Pointer => {
// Copy current background to backbuffer
let buffer_size = self
.pointer_backbuffer
.len()
.max(pointer_src_rect_width * pointer_src_rect_height * 4);
self.pointer_backbuffer.resize(buffer_size, 0);
copy_cursor_data(
&self.data,
(pointer_draw_x, pointer_draw_y),
width * 4,
&mut self.pointer_backbuffer,
pointer_src_rect_width * 4,
(0, 0),
(pointer_src_rect_width, pointer_src_rect_height),
(width, height),
false,
);
// Draw pointer (with compositing)
copy_cursor_data(
pointer.bitmap_data.as_slice(),
(
usize::from(self.pointer_src_rect.left),
usize::from(self.pointer_src_rect.top),
),
usize::from(pointer.width) * 4,
&mut self.data,
width * 4,
(pointer_draw_x, pointer_draw_y),
(pointer_src_rect_width, pointer_src_rect_height),
(width, height),
true,
);
}
}
// Request redraw of the changed area
Ok(Some(dest_rect))
}
pub(crate) fn show_pointer(&mut self) -> SessionResult<Option<InclusiveRectangle>> {
if !self.show_pointer {
self.show_pointer = true;
self.apply_pointer_layer(PointerLayer::Pointer)
} else {
Ok(None)
}
}
pub(crate) fn hide_pointer(&mut self) -> SessionResult<Option<InclusiveRectangle>> {
if self.show_pointer {
self.show_pointer = false;
self.apply_pointer_layer(PointerLayer::Background)
} else {
Ok(None)
}
}
fn recalculate_pointer_geometry(&mut self) {
let x = self.pointer_x;
let y = self.pointer_y;
let pointer = match &self.pointer {
Some(pointer) if self.show_pointer => pointer,
_ => return,
};
let left_virtual = i32::from(x) - i32::from(pointer.hotspot_x);
let top_virtual = i32::from(y) - i32::from(pointer.hotspot_y);
let right_virtual = left_virtual + i32::from(pointer.width) - 1;
let bottom_virtual = top_virtual + i32::from(pointer.height) - 1;
let (left, draw_x) = if left_virtual < 0 {
// Cut left side if required
(pointer.hotspot_x - x, 0)
} else {
(0, x - pointer.hotspot_x)
};
let (top, draw_y) = if top_virtual < 0 {
// Cut top side if required
(pointer.hotspot_y - y, 0)
} else {
(0, y - pointer.hotspot_y)
};
// Cut right side if required
let right = if right_virtual >= i32::from(self.width - 1) {
if draw_x + 1 >= self.width {
// Pointer is completely out of bounds horizontally
self.pointer_visible_on_screen = false;
return;
} else {
self.width - (draw_x + 1)
}
} else {
pointer.width - 1
};
// Cut bottom side if required
let bottom = if bottom_virtual >= i32::from(self.height - 1) {
if (draw_y + 1) >= self.height {
// Pointer is completely out of bounds vertically
self.pointer_visible_on_screen = false;
return;
} else {
self.height - (draw_y + 1)
}
} else {
pointer.height - 1
};
self.pointer_visible_on_screen = true;
let pointer_src_rect = InclusiveRectangle {
left,
top,
right,
bottom,
};
self.pointer_src_rect = pointer_src_rect;
self.pointer_draw_x = draw_x;
self.pointer_draw_y = draw_y;
}
pub(crate) fn move_pointer(&mut self, x: u16, y: u16) -> SessionResult<Option<InclusiveRectangle>> {
self.pointer_x = x;
self.pointer_y = y;
if self.pointer.is_some() && self.show_pointer {
let old_rect = self.apply_pointer_layer(PointerLayer::Background)?;
self.recalculate_pointer_geometry();
let new_rect = self.apply_pointer_layer(PointerLayer::Pointer)?;
match (old_rect, new_rect) {
(None, None) => Ok(None),
(None, Some(rect)) => Ok(Some(rect)),
(Some(rect), None) => Ok(Some(rect)),
(Some(a), Some(b)) => Ok(Some(a.union(&b))),
}
} else {
Ok(None)
}
}
pub(crate) fn update_pointer(&mut self, pointer: Arc<DecodedPointer>) -> SessionResult<Option<InclusiveRectangle>> {
self.show_pointer = true;
// Remove old pointer from frame buffer
let old_rect = if self.pointer.is_some() {
self.apply_pointer_layer(PointerLayer::Background)?
} else {
None
};
self.pointer = Some(pointer);
self.recalculate_pointer_geometry();
// Draw new pointer
let new_rect = self.apply_pointer_layer(PointerLayer::Pointer)?;
match (old_rect, new_rect) {
(None, None) => Ok(None),
(None, Some(rect)) => Ok(Some(rect)),
(Some(rect), None) => Ok(Some(rect)),
(Some(a), Some(b)) => Ok(Some(a.union(&b))),
}
}
fn is_pointer_redraw_required(&self, update_rectangle: &InclusiveRectangle) -> bool {
let pointer_dest_rect = InclusiveRectangle {
left: self.pointer_draw_x,
top: self.pointer_draw_y,
right: self.pointer_draw_x + self.pointer_src_rect.width() - 1,
bottom: self.pointer_draw_y + self.pointer_src_rect.height() - 1,
};
update_rectangle.intersect(&pointer_dest_rect).is_some() && self.show_pointer
}
/// This method should be called BEFORE and framebuffer updates, with the update rectangle,
/// to determine if the pointer needs to be redrawn (overlapping with the update rectangle).
fn pointer_rendering_begin(
&mut self,
update_rectangle: &InclusiveRectangle,
) -> SessionResult<PointerRenderingState> {
if !self.is_pointer_redraw_required(update_rectangle) || self.pointer.is_none() {
return Ok(PointerRenderingState {
redraw: false,
update_rectangle: update_rectangle.clone(),
});
}
let state = self
.apply_pointer_layer(PointerLayer::Background)?
.map(|cursor_erase_rect| PointerRenderingState {
redraw: true,
update_rectangle: cursor_erase_rect.union(update_rectangle),
})
.unwrap_or_else(|| PointerRenderingState {
redraw: false,
update_rectangle: update_rectangle.clone(),
});
Ok(state)
}
fn pointer_rendering_end(
&mut self,
pointer_rendering_state: PointerRenderingState,
) -> SessionResult<InclusiveRectangle> {
if !pointer_rendering_state.redraw {
return Ok(pointer_rendering_state.update_rectangle);
}
let update_rectangle = self
.apply_pointer_layer(PointerLayer::Pointer)?
.map(|pointer_draw_rectangle| pointer_draw_rectangle.union(&pointer_rendering_state.update_rectangle))
.unwrap_or_else(|| pointer_rendering_state.update_rectangle);
Ok(update_rectangle)
}
// To apply the buffer, we need to un-apply previously drawn cursor, and then apply it again
// in other position.
pub(crate) fn apply_tile(
&mut self,
tile_output: &[u8],
pixel_format: PixelFormat,
clipping_rectangles: &Region,
update_rectangle: &InclusiveRectangle,
) -> SessionResult<InclusiveRectangle> {
trace!("Tile: {:?}", update_rectangle);
if !self.rect_fits(&clipping_rectangles.extents) {
debug!(
"Skipping tile update {:?} outside image bounds {}x{}",
clipping_rectangles.extents, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
let pointer_rendering_state = self.pointer_rendering_begin(&clipping_rectangles.extents)?;
let update_region = clipping_rectangles.intersect_rectangle(update_rectangle);
for region_rectangle in &update_region.rectangles {
let source_x = region_rectangle.left - update_rectangle.left;
let source_y = region_rectangle.top - update_rectangle.top;
let stride = u16::from(pixel_format.bytes_per_pixel()) * TILE_SIZE;
let source_image_region = ImageRegion {
region: InclusiveRectangle {
left: source_x,
top: source_y,
right: source_x + region_rectangle.width() - 1,
bottom: source_y + region_rectangle.height() - 1,
},
data: tile_output,
step: stride,
pixel_format,
};
let mut destination_image_region = ImageRegionMut {
region: region_rectangle.clone(),
step: self.width() * u16::from(self.pixel_format.bytes_per_pixel()),
pixel_format: self.pixel_format,
data: &mut self.data,
};
trace!("Source image region: {:?}", source_image_region.region);
trace!("Destination image region: {:?}", destination_image_region.region);
source_image_region
.copy_to(&mut destination_image_region)
.map_err(|e| custom_err!("copy_to", e))?;
}
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
pub(crate) fn apply_rgb16_bitmap(
&mut self,
rgb16: &[u8],
update_rectangle: &InclusiveRectangle,
source_width: u16,
) -> SessionResult<InclusiveRectangle> {
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgb16 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 2;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let rectangle_width = usize::from(update_rectangle.width());
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
rgb16
.chunks_exact(source_width * SRC_COLOR_DEPTH)
.rev()
.take(rectangle_height)
.enumerate()
.for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(rectangle_width)
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let rgb16_value = u16::from_le_bytes(
src_pixel
.try_into()
.expect("src_pixel contains exactly two u8 elements"),
);
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
let [r, g, b] = rdp_16bit_to_rgb(rgb16_value);
self.data[dst_idx + ri] = r;
self.data[dst_idx + gi] = g;
self.data[dst_idx + bi] = b;
self.data[dst_idx + ai] = 0xff;
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
/// Apply a 15-bit (RGB555) bitmap. Bottom-up row order, 2 bytes per pixel.
pub(crate) fn apply_rgb15_bitmap(
&mut self,
rgb15: &[u8],
update_rectangle: &InclusiveRectangle,
source_width: u16,
) -> SessionResult<InclusiveRectangle> {
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgb15 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 2;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let rectangle_width = usize::from(update_rectangle.width());
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
rgb15
.chunks_exact(source_width * SRC_COLOR_DEPTH)
.rev()
.take(rectangle_height)
.enumerate()
.for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(rectangle_width)
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let rgb15_value = u16::from_le_bytes(
src_pixel
.try_into()
.expect("src_pixel contains exactly two u8 elements"),
);
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
let [r, g, b] = rdp_15bit_to_rgb(rgb15_value);
self.data[dst_idx + ri] = r;
self.data[dst_idx + gi] = g;
self.data[dst_idx + bi] = b;
self.data[dst_idx + ai] = 0xff;
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
/// Apply a 24-bit BGR bitmap. RLE 24bpp decompresses to BGR byte order,
/// and uncompressed 24bpp bitmaps are also BGR per MS-RDPBCGR.
/// Bottom-up row order, 3 bytes per pixel.
pub(crate) fn apply_bgr24_bitmap(
&mut self,
bgr24: &[u8],
update_rectangle: &InclusiveRectangle,
source_width: u16,
) -> SessionResult<InclusiveRectangle> {
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping bgr24 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 3;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let rectangle_width = usize::from(update_rectangle.width());
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
bgr24
.chunks_exact(source_width * SRC_COLOR_DEPTH)
.rev()
.take(rectangle_height)
.enumerate()
.for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(rectangle_width)
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
// BGR -> RGB channel swap
self.data[dst_idx + ri] = src_pixel[2];
self.data[dst_idx + gi] = src_pixel[1];
self.data[dst_idx + bi] = src_pixel[0];
self.data[dst_idx + ai] = 0xff;
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
/// Apply an 8-bit palette-indexed bitmap. Each source byte is a palette index.
/// Bottom-up row order.
pub(crate) fn apply_rgb8_with_palette(
&mut self,
indexed: &[u8],
update_rectangle: &InclusiveRectangle,
palette: &[[u8; 3]; 256],
source_width: u16,
) -> SessionResult<InclusiveRectangle> {
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgb8 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let rectangle_width = usize::from(update_rectangle.width());
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
indexed
.chunks_exact(source_width)
.rev()
.take(rectangle_height)
.enumerate()
.for_each(|(row_idx, row)| {
row.iter()
.take(rectangle_width)
.enumerate()
.for_each(|(col_idx, &index)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
let [r, g, b] = palette[usize::from(index)];
self.data[dst_idx + ri] = r;
self.data[dst_idx + gi] = g;
self.data[dst_idx + bi] = b;
self.data[dst_idx + ai] = 0xff;
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
fn apply_rgb24_iter<'a, I>(
&mut self,
rgb24: I,
update_rectangle: &InclusiveRectangle,
) -> SessionResult<InclusiveRectangle>
where
I: Iterator<Item = &'a [u8]>,
{
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgb24 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 3;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
rgb24.enumerate().for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(usize::from(update_rectangle.width()))
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
self.data[dst_idx + ri] = src_pixel[0];
self.data[dst_idx + gi] = src_pixel[1];
self.data[dst_idx + bi] = src_pixel[2];
self.data[dst_idx + ai] = 0xFF;
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
pub(crate) fn apply_rgb24(
&mut self,
rgb24: &[u8],
update_rectangle: &InclusiveRectangle,
source_width: u16,
flip: bool,
) -> SessionResult<InclusiveRectangle> {
const SRC_COLOR_DEPTH: usize = 3;
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let lines = rgb24.chunks_exact(source_width * SRC_COLOR_DEPTH);
if flip {
self.apply_rgb24_iter(lines.rev().take(rectangle_height), update_rectangle)
} else {
self.apply_rgb24_iter(lines.take(rectangle_height), update_rectangle)
}
}
#[cfg(feature = "qoi")]
fn apply_rgba32_iter<'a, I>(
&mut self,
rgba32: I,
update_rectangle: &InclusiveRectangle,
) -> SessionResult<InclusiveRectangle>
where
I: Iterator<Item = &'a [u8]>,
{
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgba32 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 4;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
rgba32.enumerate().for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
self.data[dst_idx + ri] = src_pixel[0];
self.data[dst_idx + gi] = src_pixel[1];
self.data[dst_idx + bi] = src_pixel[2];
self.data[dst_idx + ai] = src_pixel[3];
})
});
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
#[cfg(feature = "qoi")]
pub(crate) fn apply_rgba32(
&mut self,
rgba32: &[u8],
update_rectangle: &InclusiveRectangle,
flip: bool,
) -> SessionResult<InclusiveRectangle> {
const SRC_COLOR_DEPTH: usize = 4;
let rectangle_width = usize::from(update_rectangle.width());
let lines = rgba32.chunks_exact(rectangle_width * SRC_COLOR_DEPTH);
if flip {
self.apply_rgba32_iter(lines.rev(), update_rectangle)
} else {
self.apply_rgba32_iter(lines, update_rectangle)
}
}
pub(crate) fn apply_rgb32_bitmap(
&mut self,
rgb32: &[u8],
format: PixelFormat,
update_rectangle: &InclusiveRectangle,
source_width: u16,
) -> SessionResult<InclusiveRectangle> {
if !self.rect_fits(update_rectangle) {
debug!(
"Skipping rgb32 update {:?} outside image bounds {}x{}",
update_rectangle, self.width, self.height,
);
return Ok(InclusiveRectangle::empty());
}
const SRC_COLOR_DEPTH: usize = 4;
const DST_COLOR_DEPTH: usize = 4;
let image_width = usize::from(self.width);
let rectangle_width = usize::from(update_rectangle.width());
let source_width = usize::from(source_width);
let rectangle_height = usize::from(update_rectangle.height());
let top = usize::from(update_rectangle.top);
let left = usize::from(update_rectangle.left);
let pointer_rendering_state = self.pointer_rendering_begin(update_rectangle)?;
if format == self.pixel_format {
rgb32
.chunks_exact(source_width * SRC_COLOR_DEPTH)
.rev()
.take(rectangle_height)
.enumerate()
.for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(rectangle_width)
.enumerate()
.for_each(|(col_idx, src_pixel)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
self.data[dst_idx..dst_idx + SRC_COLOR_DEPTH].copy_from_slice(src_pixel);
})
});
} else {
let [ri, gi, bi, ai] = self.pixel_format.channel_offsets();
rgb32
.chunks_exact(source_width * SRC_COLOR_DEPTH)
.rev()
.take(rectangle_height)
.enumerate()
.try_for_each(|(row_idx, row)| {
row.chunks_exact(SRC_COLOR_DEPTH)
.take(rectangle_width)
.enumerate()
.try_for_each(|(col_idx, src_pixel)| {
let dst_idx = ((top + row_idx) * image_width + left + col_idx) * DST_COLOR_DEPTH;
let c = format
.read_color(src_pixel)
.map_err(|err| custom_err!("read color", err))?;
self.data[dst_idx + ri] = c.r;
self.data[dst_idx + gi] = c.g;
self.data[dst_idx + bi] = c.b;
self.data[dst_idx + ai] = c.a;
Ok(())
})?;
Ok(())
})?;
}
let update_rectangle = self.pointer_rendering_end(pointer_rendering_state)?;
Ok(update_rectangle)
}
}
#[cfg(test)]
mod tests {
use super::*;
fn pixel(image: &DecodedImage, x: usize, y: usize) -> [u8; 4] {
let offset = (y * usize::from(image.width()) + x) * 4;
image.data()[offset..offset + 4]
.try_into()
.expect("pixel has four channels")
}
#[test]
fn bgr_bitmap_crops_source_stride_and_preserves_bottom_up_orientation() {
let mut image = DecodedImage::new(PixelFormat::RgbA32, 4, 3);
let rectangle = InclusiveRectangle {
left: 1,
top: 0,
right: 2,
bottom: 1,
};
// The wire data is bottom-up, with two extra source columns per row.
let bgr = [
3, 2, 1, 6, 5, 4, 9, 8, 7, 12, 11, 10, // bottom row
15, 14, 13, 18, 17, 16, 21, 20, 19, 24, 23, 22, // top row
];
image.apply_bgr24_bitmap(&bgr, &rectangle, 4).unwrap();
assert_eq!(pixel(&image, 1, 0), [13, 14, 15, 255]);
assert_eq!(pixel(&image, 2, 0), [16, 17, 18, 255]);
assert_eq!(pixel(&image, 1, 1), [1, 2, 3, 255]);
assert_eq!(pixel(&image, 2, 1), [4, 5, 6, 255]);
assert_eq!(pixel(&image, 3, 0), [0, 0, 0, 0]);
}
#[test]
fn rgb24_bitmap_crops_source_stride_and_preserves_top_down_orientation() {
let mut image = DecodedImage::new(PixelFormat::RgbA32, 4, 3);
let rectangle = InclusiveRectangle {
left: 1,
top: 0,
right: 2,
bottom: 1,
};
// RDP6 decoding produces row-major RGB data, so no row flip is required.
let rgb = [
1, 2, 3, 4, 5, 6, 90, 91, 92, 93, 94, 95, // top row
13, 14, 15, 16, 17, 18, 96, 97, 98, 99, 100, 101, // bottom row
];
image.apply_rgb24(&rgb, &rectangle, 4, false).unwrap();
assert_eq!(pixel(&image, 1, 0), [1, 2, 3, 255]);
assert_eq!(pixel(&image, 2, 0), [4, 5, 6, 255]);
assert_eq!(pixel(&image, 1, 1), [13, 14, 15, 255]);
assert_eq!(pixel(&image, 2, 1), [16, 17, 18, 255]);
assert_eq!(pixel(&image, 3, 1), [0, 0, 0, 0]);
}
}