LUMIERA.clone/tests/core/steam/fixture/fixture-segment-test.cpp
Ichthyostega 0933d2bba8 Dispatcher-Pipeline: simplify JobTicket and remove channel differentiation
The existing implementation of the Player from 2012~2015 inclduded
an additional differentiation by media channel (for multichannel media)
and would build a separate CalcStream for each channel.

The in-depth analysis conducted for the ongoing »Vertical Slice« effort
revealed that this differentiation is besides the point and would never
be materialised: Since -- by definition -- all media processing has
to be done by the engine, also the generation of the final output format
including any channel multiplexing will happen in render nodes.
The only exception would be when only a single channel of multichannel
media is extracted -- yet this case would then translate into a
dedicated ModelPort.

Based on this reasoning, a lot of complexity (and some contradictions)
within the JobTicket implementation can be removed -- together with
some further leftovers of the fist attempt to build JobTickets always
from a Mock specification (we now use construction by the Segment,
based on an ExitNode, which is the expected actual implementation
for production setup)
2023-06-12 00:04:45 +02:00

137 lines
5 KiB
C++

/*
FixtureSegment(Test) - verify properties of a single segment in the fixture
Copyright (C) Lumiera.org
2023, Hermann Vosseler <Ichthyostega@web.de>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
* *****************************************************/
/** @file node-graph-attachment-test.cpp
** unit test \ref NodeGraphAttachment_test
*/
#include "lib/test/run.hpp"
#include "steam/fixture/node-graph-attachment.hpp"
#include "steam/engine/mock-dispatcher.hpp"
#include "steam/engine/frame-coord.hpp"
#include "steam/engine/exit-node.hpp"
#include "lib/util.hpp"
#include <utility>
namespace steam {
namespace fixture {
namespace test {
using std::move;
using util::isnil;
using util::isSameObject;
using engine::ExitNode;
using lib::diff::MakeRec;
using engine::Job;
using engine::JobTicket;
using engine::test::MockSegmentation;
/*****************************************************************************//**
* @test Verify properties and behaviour of a single Segment in the Segmentation
* - construction of a mocked Segment
* - on-demand allocation of a JobTicket for a ModelPort(index)
* - TODO
* @see steam::fixture::Segment
* @see JobPlanningSetup_test
* @see MockSupport_test
*/
class FixtureSegment_test : public Test
{
virtual void
run (Arg)
{
fabricate_MockSegment();
retrieve_JobTicket();
}
/** @test setup a properly structured ExitNode graph using the
* specification scheme supported by MockSegmentation
* @see MockSupport_test::verify_MockSegmentation
*/
void
fabricate_MockSegment()
{
// Build a Segmentation partitioned at 10s
MockSegmentation segmentation{MakeRec()
.attrib ("start", Time{0,10}
,"mark", 101010)
.genNode()};
CHECK (2 == segmentation.size());
Segment const& seg = segmentation[Time{0,20}]; // access anywhere >= 10s
CHECK (Time(0,10) == seg.start());
CHECK (Time::NEVER == seg.after());
CHECK (101010 == seg.exitNode[0].getPipelineIdentity());
}
/** @test on-demand generate a JobTicket from an existing NodeGraphAttachment
*/
void
retrieve_JobTicket()
{
MockSegmentation segmentation{MakeRec()
.attrib("mark", 13) // top-level: marked with hash/id = 13
.scope(MakeRec() // ... defines two nested prerequisites
.attrib("mark",23) // + Prerequisite-1 hash/id = 23
.genNode()
,MakeRec()
.attrib("mark",55) // + Prerequisite-2 hash/id = 55
.genNode()
)
.genNode()};
CHECK (1 == segmentation.size()); // whole time axis covered by one segment
Segment const& seg = segmentation[Time::ANYTIME]; // thus accessed time point is irrelevant
// verify mapped JobTicket is assembled according to above spec...
auto getMarker = [](JobTicket const& ticket)
{
engine::FrameCoord dummyFrame;
Job job = ticket.createJobFor(dummyFrame);
return job.parameter.invoKey.part.a;
};
JobTicket const& ticket = seg.jobTicket(0);
CHECK (13 == getMarker (ticket));
auto prereq = ticket.getPrerequisites();
CHECK (not isnil(prereq));
CHECK (55 == getMarker (*prereq)); // Note: order of prerequisites is flipped (by LinkedElements)
++prereq;
CHECK (23 == getMarker (*prereq));
++prereq;
CHECK (isnil(prereq));
}
};
/** Register this test class... */
LAUNCHER (FixtureSegment_test, "unit fixture");
}}} // namespace steam::fixture::test