Struct FakeCameraBuilder 

pub struct FakeCameraBuilder { /* private fields */ }

Builder for configuring and starting a fake GigE Vision camera.

Implementations

impl FakeCameraBuilder

pub fn width(self, width: u32) -> Self

Set the image width in pixels.

pub fn height(self, height: u32) -> Self

Set the image height in pixels.

pub fn fps(self, fps: u32) -> Self

Set the target frame rate.

pub fn bind_ip(self, ip: Ipv4Addr) -> Self

Set the IPv4 address to bind the GVCP socket to.

pub fn port(self, port: u16) -> Self

Set the GVCP control port (default: 3956).

pub fn pixel_format(self, code: u32) -> Self

Set the initial pixel format (PFNC code). Default: Mono8.

Use MONO8 or RGB8 constants.

pub fn zip_xml(self, enable: bool) -> Self

Serve the GenApi XML as a ZIP archive (default: plain XML).

Many real cameras (Basler, FLIR, Hikrobot, …) publish their register-description XML zipped; enable this to exercise that path.

pub fn enforce_heartbeat(self, enable: bool) -> Self

Release control privilege when the controller stops sending GVCP commands for longer than GevHeartbeatTimeout (default: off).

See registers::RegisterMap::enforce_heartbeat for why this is not the default even though every real device behaves this way.

pub fn max_packet_size(self, max: u32) -> Self

Clamp GevSCPSPacketSize to max, the way a real camera caps it.

A request above max is acknowledged and silently reduced, so the register reads back lower than what was written. Off by default: the fake accepts any size, which is what every existing test expects.

The fake accepted anything until 0.4.1, so it could not express the camera behind #112 and no test could have caught that defect — the ADR-0019 failure mode of a fake that only ever agrees with its client.

pub fn max_on_wire(self, max: u32) -> Self

Silently drop any GVSP datagram larger than max, as a network path with a smaller frame ceiling than either endpoint believes does.

Different from FakeCameraBuilder::max_packet_size, and the difference is the whole of #112: that camera accepts and stores 16114, then streams nothing, because the link tops out at a 9216-byte frame. No register read can find that — only a test packet can.

pub fn heartbeat_timeout_ms(self, timeout_ms: u32) -> Self

Report a different GevHeartbeatTimeout than the 3 000 ms default.

A shorter window keeps a test that has to wait one out from dominating the suite’s runtime.

pub async fn build(self) -> Result<FakeCamera, Error>

Start the fake camera and return a handle.

Trait Implementations

impl Default for FakeCameraBuilder

fn default() -> Self

Returns the “default value” for a type.