Description

A faked »media calculation« environment to validate the render node network.

Definition in file test-rand-ontology.hpp.

#include "lib/error.hpp"
#include "lib/symbol.hpp"
#include "lib/depend.hpp"
#include "lib/nocopy.hpp"
#include "lib/format-string.hpp"
#include "steam/engine/testframe.hpp"
#include <array>
#include <string>

Classes
struct	TestRandOntology::Spec

class	TestRandOntology
	A fake Domain Ontology to describe mocked »render operations« on dummy data frames filled with random numbers. More...

Typedefs
using	NoArg = std::array< char *, 0 >

using	SoloArg = std::array< char *, 1 >

Functions
void	combineFrames (TestFrame out, TestFrame const srcA, TestFrame const *srcB, double mix)
	mix two random data frames by a parameter-controlled proportion More...

void	dummyOp (NoArg in, SoloArg out)

void	duplicateMultichan (TestFrame outArry, TestFrame inArry, uint chanCnt)
	create an identical clone copy of the planar multi channel frame array More...

void	generateFrame (TestFrame *buff, size_t frameNr=0, uint flavour=0)
	produce sequences of frames with (reproducible) random data More...

void	generateMultichan (TestFrame *buffArry, uint chanCnt, size_t frameNr=0, uint flavour=0)
	produce planar multi channel output of random data frames More...

void	manipulateFrame (TestFrame out, TestFrame const in, uint64_t param)
	»process« random frame date by hash-chaining with a parameter. More...

void	manipulateMultichan (TestFrame *buffArry, uint chanCnt, uint64_t param)
	»process« a planar multi channel array of data frames in-place. More...

Namespaces
	steam
	Steam-Layer implementation namespace root.

	steam::engine
	Lumiera's render engine core and operational control.

Function Documentation

◆ generateFrame()

void generateFrame	(	TestFrame *	buff,
		size_t	frameNr,
		uint	flavour
	)

produce sequences of frames with (reproducible) random data

Parameters

buff	a sufficiently sized allocation to place the result data into
frameNr	the frame of the »source feed« to generate (determines actual random data)
flavour	a further seed parameter to determine the actual (reproducibly) random data

Definition at line 56 of file test-rand-ontology.cpp.

References steam::engine::test::generateFrame().

Referenced by steam::engine::test::generateFrame(), and NodeDevel_test::processing_generateFrame().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ generateMultichan()

void generateMultichan	(	TestFrame *	buffArry,
		uint	chanCnt,
		size_t	frameNr,
		uint	flavour
	)

produce planar multi channel output of random data frames

Parameters

chanCnt	size of the array of frames to generate
buffArry	pointer to an allocation sufficiently sized to hold `TestFrame[chanCnt]`
frameNr	the frame of the »source feed« to use commonly on all those frames in the output
flavour	a further seed parameter used as starting offest for the output's `family` parameters

Remarks: this is a variation of the dummy data generator, which immediately generates a planar block of related frames with random data, all seeded with the same frameNr and consecutive family parameters, which will be offset commonly by adding the flavour parameter.

Definition at line 73 of file test-rand-ontology.cpp.

References steam::engine::test::generateMultichan().

Referenced by steam::engine::test::generateMultichan(), NodeDevel_test::processing_duplicateMultichan(), NodeDevel_test::processing_generateMultichan(), and NodeDevel_test::processing_manipulateMultichan().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateMultichan()

void duplicateMultichan	(	TestFrame *	outArry,
		TestFrame *	inArry,
		uint	chanCnt
	)

create an identical clone copy of the planar multi channel frame array

Parameters

chanCnt	size of the array of frames to clone
inArry	pointer to storage holding a TestFrame[chanCnt]
outArry	pointer to allocated storage sufficient to hold a clone copy of these

Definition at line 86 of file test-rand-ontology.cpp.

References steam::engine::test::duplicateMultichan().

Referenced by steam::engine::test::duplicateMultichan(), NodeDevel_test::processing_duplicateMultichan(), and NodeDevel_test::processing_manipulateMultichan().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ manipulateMultichan()

void manipulateMultichan	(	TestFrame *	buffArry,
		uint	chanCnt,
		uint64_t	param
	)

»process« a planar multi channel array of data frames in-place.

Parameters

chanCnt	size of the array of frames to manipulate
buffArry	pointer to an array of several frames (channels)
param	parameter to control or »mark« the data manipulation (hash-combining)

Remarks: this function in-place processing of several channels in one step: data is processed in 64-bit words, by hash-chaining with param and then joining in the data items. All data buffers will be manipulated and marked with as valid with a new checksum.

Definition at line 103 of file test-rand-ontology.cpp.

References lib::hash::combine(), and steam::engine::test::manipulateMultichan().

Referenced by steam::engine::test::manipulateMultichan(), and NodeDevel_test::processing_manipulateMultichan().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ manipulateFrame()

void manipulateFrame	(	TestFrame *	out,
		TestFrame const *	in,
		uint64_t	param
	)

»process« random frame date by hash-chaining with a parameter.

Parameters

out	existing allocation to place the generated TestFrame into
in	allocation holding the input TestFrame data
param	parameter to control or »mark« the data manipulation (hash-combining)

Remarks: this function emulates „media data processing“: data is processed in 64-bit words, by hash-chaining with param. The generated result is marked with a valid checksum.

Definition at line 129 of file test-rand-ontology.cpp.

References lib::hash::combine(), steam::engine::test::manipulateFrame(), TestFrame::markChecksum(), and lib::zip().

Referenced by steam::engine::test::manipulateFrame(), and NodeDevel_test::processing_manipulateFrame().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ combineFrames()

void combineFrames	(	TestFrame *	out,
		TestFrame const *	srcA,
		TestFrame const *	srcB,
		double	mix
	)

mix two random data frames by a parameter-controlled proportion

Parameters

out	existing allocation to receive the calculated result TestFrame
srcA	a buffer holding the input data for feed-A
srcB	a buffer holding the input data for feed-B
mix	degree of mixing (by integer arithmetics): 100 means 100% feed-B

Remarks: this function emulates a mixing or overlaying operation: each result byte is the linear interpolation between the corresponding inputs.

Definition at line 148 of file test-rand-ontology.cpp.

References steam::engine::test::combineFrames(), TestFrame::data(), TestFrame::markChecksum(), and lib::zip().

Referenced by steam::engine::test::combineFrames(), and NodeDevel_test::processing_combineFrames().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dummyOp()

void steam::engine::test::dummyOp	(	NoArg	in,
		SoloArg	out
	)

inline

Todo:: a placeholder operation to wire a prototypical render node

Definition at line 71 of file test-rand-ontology.hpp.

References steam::engine::test::dummyOp().

Referenced by steam::engine::test::dummyOp().

Here is the call graph for this function:

Here is the caller graph for this function:

Description

Classes

Typedefs

Functions

Namespaces

Function Documentation

◆ generateFrame()

◆ generateMultichan()

◆ duplicateMultichan()

◆ manipulateMultichan()

◆ manipulateFrame()

◆ combineFrames()

◆ dummyOp()