Struct Viewport 

pub struct Viewport {
    pub width: u32,
    pub height: u32,
    pub device_scale_factor: f64,
    pub is_mobile: bool,
    pub has_touch: bool,
    pub is_landscape: bool,
}

Viewport configuration for controlling page dimensions and device emulation.

Similar to Puppeteer’s page.setViewport(), this allows you to control the page dimensions and device scale factor for higher quality screenshots.

Example

use cdp_html_shot::Viewport;

// Create a high-DPI viewport for sharper images
let viewport = Viewport::new(1920, 1080)
    .with_device_scale_factor(2.0);

// Or use builder pattern for full control
let viewport = Viewport::builder()
    .width(1280)
    .height(720)
    .device_scale_factor(3.0)
    .is_mobile(false)
    .build();

Fields

width: u32

Viewport width in pixels.

height: u32

Viewport height in pixels.

device_scale_factor: f64

Device scale factor (DPR). Higher values (e.g., 2.0, 3.0) produce sharper images. Default is 1.0.

is_mobile: bool

Whether to emulate a mobile device. Default is false.

has_touch: bool

Whether touch events are supported. Default is false.

is_landscape: bool

Whether viewport is in landscape mode. Default is false.

Implementations

impl Viewport

pub fn new(width: u32, height: u32) -> Self

Creates a new viewport with specified dimensions and default settings.

pub fn builder() -> ViewportBuilder

Creates a new viewport builder for fluent configuration.

pub fn with_device_scale_factor(self, factor: f64) -> Self

Sets the device scale factor (DPR) for higher quality images.

Common values:

• 1.0: Standard resolution
• 2.0: Retina/HiDPI (2x sharper)
• 3.0: Ultra-high DPI (3x sharper)

pub fn with_mobile(self, is_mobile: bool) -> Self

Sets whether to emulate a mobile device.

pub fn with_touch(self, has_touch: bool) -> Self

Sets whether touch events are supported.

pub fn with_landscape(self, is_landscape: bool) -> Self

Sets whether the viewport is in landscape mode.

Trait Implementations

impl Clone for Viewport

fn clone(&self) -> Viewport

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Viewport

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Viewport

fn default() -> Self

Returns the “default value” for a type.