ra8_camera_stream.c File Reference

ra8_camera encoded-frame to ra8_io_stream bridge. More...

#include "ra8_camera_stream.h"
#include <stddef.h>
#include <stdint.h>
#include "ra8_camera.h"
#include "ra8_err.h"
#include "ra8_io_stream.h"

Include dependency graph for ra8_camera_stream.c:

Go to the source code of this file.

Functions
ra8_err_t	ra8_camera_codec_encode_to_stream (ra8_camera_codec_t *codec, const ra8_camera_frame_t *input, const ra8_camera_buffer_t *output_buffer, ra8_io_stream_t *stream, uint32_t *out_written)
	Encode one frame and write the complete result to a byte stream.

Detailed Description

ra8_camera encoded-frame to ra8_io_stream bridge.

Tag

[Ring 4 / Service] {World: NS}

Produces a frame view through the selected codec, then forwards its complete byte slice to the selected stream sink without allocation.

Copyright

Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since

0.1.0

Definition in file ra8_camera_stream.c.

Function Documentation

ra8_camera_codec_encode_to_stream()

ra8_err_t ra8_camera_codec_encode_to_stream ( ra8_camera_codec_t * codec, const ra8_camera_frame_t * input, const ra8_camera_buffer_t * output_buffer, ra8_io_stream_t * stream, uint32_t * out_written )

nodiscard

Encode one frame and write the complete result to a byte stream.

Calls ra8_camera_codec_encode, then one ra8_io_stream_write. It deliberately does not flush: callers may append a protocol trailer or batch several frames before committing a buffered sink.

Parameters

[in,out]	codec	Bound camera codec.
[in]	input	Valid source frame.
[in]	output_buffer	Caller-owned codec output storage.
[in,out]	stream	Bound output stream.
[out]	out_written	Bytes accepted by the stream, or NULL.

Returns

ra8_err_t Error code.

Return values

k_ra8_ok	Whole encoded frame written.
k_ra8_err_null_ptr	A required argument was NULL.
k_ra8_err_invalid_size	A nominally successful sink accepted only a prefix of the encoded frame.
other	Propagated from the codec or stream.

Precondition

Input and output storage satisfy ra8_camera_codec_encode.

stream is bound and idle.

Postcondition

On success exactly one complete encoded frame was written.

*out_written, when provided, reports the accepted byte count.

Note

Not thread-safe with respect to the same codec, buffers, or stream.

Since

0.1.0

Definition at line 26 of file ra8_camera_stream.c.

References ra8_camera_frame_t::bytes, ra8_camera_frame_t::data, k_ra8_err_invalid_size, k_ra8_err_null_ptr, k_ra8_ok, ra8_camera_codec_encode(), and ra8_io_stream_write().