Files
oak-editor/tests/gtest/dynamic_render_backend_test.cpp
Mike-Solar 712badbaa7 build/ci: green builds and tests on all three platforms
Compiler hygiene (all platforms):
- Silence warnings across the tree: missing override, -Wreorder ctor
  init, -Wshadow, -Wsign-compare, missing switch cases, unused
  functions/captures, Qt 6.11 deprecations (QMouseEvent/QDropEvent
  accessors, qAsConst, Q_FOREACH over non-shared containers,
  AA_UseHighDpiPixmaps) and the .bak/ backup tree removal.
- Fix regressions from the cleanup: missing clip decls in
  capi/timeline.cpp, plugin.cpp rename fallout, panel setFocus
  ambiguity, QGraphicsItem::pos vs event->position(), duplicate
  k_push_button case, boolean test variable.

Windows:
- Qt portability: CommandLineParser is_set/add_option, QTimeZone
  systemTimeZone (QTimeZone::LocalTime is 6.11-only), k_progress_* enum.
- Linking: stop adding oakengine to OLIVE_LIBRARIES (import lib plus
  oakengine-obj caused multiple definitions); add OAKENGINE_STATIC so
  internal consumers no longer reference __imp_* stubs.
- oakengine.ver: export olive::Renderer typeinfo so liboakgl.so can be
  dlopened (Linux), DynamicRenderer no longer dlcloses backend libraries
  (crash in RenderManager's dtor calling into unmapped memory).
- OTIO runtime: copy DLLs next to every binary on Windows instead of
  relying on PATH (0xc0000135 in gtest discovery).
- Headless GL: the runner only has GDI OpenGL 1.1, killing every render
  worker. Deploy Mesa llvmpipe as opengl32sw.dll (Qt's software-GL
  channel) with QT_OPENGL=software, and let QT_OPENGL override the
  AA_UseDesktopOpenGL default. ExportTask fails fast after 8 consecutive
  undelivered frames instead of segfaulting or grinding forever;
  FFmpegEncoder::write_frame tolerates null frames.
- Tests: GetTempPathA+PID temp dirs, GetLongPathNameA for 8.3 names,
  forward-slash normalization when comparing project filenames.

Linux:
- Install libshaderc-dev so oakvulkan compiles GLSL (Vulkan tests).
- Accept UNORM floor-or-round (63/64) in the blit ping-pong test.
- Skip MainWindow construction test on the offscreen QPA (cannot paint
  QOpenGLWidget).

Also: oak_cli_transcode gets a 300s ctest timeout, worker logs GL
context version and LoadGraph/render_frame stages, and
docs/plans/eliminate-event-bridge-issues.md (English translation).
2026-08-04 21:34:31 +08:00

432 lines
14 KiB
C++

#include <gtest/gtest.h>
#include <QByteArray>
#include <QMatrix4x4>
#include <QOpenGLContext>
#include <QThread>
#include "node/value.h"
#include "render/backend/dynamicrenderer.h"
#include "render/job/shaderjob.h"
#include "render/shadercode.h"
#include "render/texture.h"
#include "render/videoparams.h"
// Verifies that the dynamic adapter can load the private OpenGL backend and
// query its advertised C ABI capabilities without creating a viewer context.
TEST(DynamicRenderBackend, LoadsExperimentalOpenGLBackend)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("opengl"));
if (!renderer.load()) {
GTEST_SKIP()
<< "opengl backend library could not be loaded in this environment";
}
EXPECT_EQ(renderer.open_gl_context(), nullptr);
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
EXPECT_EQ(info.abi_version, 1U);
EXPECT_EQ(info.kind, oak_render_backend_opengl);
EXPECT_STREQ(info.name, "opengl");
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_textures);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_shaders);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_blit);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_readback);
#endif
}
// Regression test: the backend renderer must follow DynamicRenderer when it is
// moved to a background thread. If it stays in the thread where Load() was
// called, GL operations are rejected as "wrong thread" and texture creation
// returns null, which manifests as a black screen.
TEST(DynamicRenderBackend, OpenGLBackendFollowsAdapterToRenderThread)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("opengl"));
if (!renderer.load()) {
GTEST_SKIP()
<< "opengl backend library could not be loaded in this environment";
}
if (!renderer.init()) {
GTEST_SKIP()
<< "OpenGL backend could not be initialized on this system";
}
QThread render_thread;
renderer.moveToThread(&render_thread);
render_thread.start();
QOpenGLContext *ctx = renderer.open_gl_context();
ASSERT_NE(ctx, nullptr);
EXPECT_EQ(ctx->thread(), &render_thread)
<< "Backend OpenGL context did not follow DynamicRenderer to render thread";
// Exercise the actual GL path in the render thread: PostInit() creates the
// offscreen surface there, and CreateTexture() must not crash.
olive::TexturePtr texture;
QMetaObject::invokeMethod(
&renderer,
[&]() {
renderer.post_init();
texture = renderer.create_texture(
olive::VideoParams(64, 64, olive::PixelFormat::u8,
olive::VideoParams::k_rgba_channel_count));
},
Qt::BlockingQueuedConnection);
render_thread.quit();
render_thread.wait();
ASSERT_NE(texture, nullptr);
EXPECT_FALSE(texture->is_dummy());
#endif
}
// Verifies Vulkan backend discovery on systems with a working Vulkan ICD. The
// test skips when the runtime correctly reports Vulkan as unavailable.
TEST(DynamicRenderBackend, LoadsExperimentalVulkanBackendWhenAvailable)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind != oak_render_backend_vulkan) {
GTEST_SKIP() << "Vulkan backend is not available on this system";
}
EXPECT_EQ(renderer.backend_name(), QStringLiteral("vulkan"));
EXPECT_EQ(renderer.open_gl_context(), nullptr);
EXPECT_STREQ(info.name, "vulkan");
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_textures);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_shaders);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_blit);
EXPECT_TRUE(info.capabilities & oak_render_backend_cap_readback);
#endif
}
// Verifies that requesting Vulkan on systems without a usable runtime falls
// back to OpenGL and reports the effective backend name.
TEST(DynamicRenderBackend, FallsBackWhenExperimentalVulkanUnavailable)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind == oak_render_backend_vulkan) {
GTEST_SKIP()
<< "Vulkan backend is available on this system; skip fallback test";
}
EXPECT_EQ(renderer.backend_name(), QStringLiteral("opengl"));
EXPECT_EQ(renderer.open_gl_context(), nullptr);
EXPECT_EQ(info.kind, oak_render_backend_opengl);
EXPECT_STREQ(info.name, "opengl");
#endif
}
// Exercises the minimal Vulkan render loop: upload a texture, run a pass-through
// shader blit, then download the destination and verify pixel data.
TEST(DynamicRenderBackend, VulkanUploadBlitDownload)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind != oak_render_backend_vulkan) {
GTEST_SKIP() << "Vulkan backend is not available on this system";
}
ASSERT_TRUE(renderer.init());
renderer.post_init();
const int k_size = 64;
olive::VideoParams params(k_size, k_size, olive::PixelFormat::u8,
olive::VideoParams::k_rgba_channel_count);
olive::TexturePtr src = renderer.create_texture(params);
ASSERT_NE(src, nullptr);
ASSERT_FALSE(src->is_dummy());
QByteArray src_data(k_size * k_size * 4, 0);
for (int i = 0; i < k_size * k_size; ++i) {
src_data[i * 4 + 0] = static_cast<char>(255); // R
src_data[i * 4 + 1] = static_cast<char>(0); // G
src_data[i * 4 + 2] = static_cast<char>(0); // B
src_data[i * 4 + 3] = static_cast<char>(255); // A
}
src->upload(src_data.data(), k_size);
olive::TexturePtr dst = renderer.create_texture(params);
ASSERT_NE(dst, nullptr);
ASSERT_FALSE(dst->is_dummy());
const QString vert =
QStringLiteral("uniform mat4 ove_mvpmat;\n"
"in vec4 a_position;\n"
"in vec2 a_texcoord;\n"
"out vec2 ove_texcoord;\n"
"void main() {\n"
" gl_Position = ove_mvpmat * a_position;\n"
" ove_texcoord = a_texcoord;\n"
"}\n");
const QString frag =
QStringLiteral("uniform sampler2D ove_maintex;\n"
"in vec2 ove_texcoord;\n"
"out vec4 frag_color;\n"
"void main() {\n"
" frag_color = texture(ove_maintex, ove_texcoord);\n"
"}\n");
QVariant shader =
renderer.create_native_shader(olive::ShaderCode(frag, vert));
ASSERT_FALSE(shader.isNull());
olive::ShaderJob job;
job.insert(QStringLiteral("ove_maintex"),
olive::NodeValue(olive::NodeValue::k_texture,
QVariant::fromValue(src)));
job.insert(QStringLiteral("ove_mvpmat"),
olive::NodeValue(olive::NodeValue::k_matrix, QMatrix4x4()));
renderer.blit_to_texture(shader, job, dst.get(), true);
QByteArray dst_data(k_size * k_size * 4, 0);
dst->download(dst_data.data(), k_size);
// The default pass-through shader should reproduce the red source pixel.
EXPECT_EQ(static_cast<uint8_t>(dst_data[0]), 255u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[1]), 0u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[2]), 0u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[3]), 255u);
#endif
}
// Ensures the Vulkan backend handles null-destination blits by rendering to a
// temporary offscreen target instead of dereferencing a missing framebuffer.
TEST(DynamicRenderBackend, VulkanNullDestinationBlitDoesNotCrash)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind != oak_render_backend_vulkan) {
GTEST_SKIP() << "Vulkan backend is not available on this system";
}
ASSERT_TRUE(renderer.init());
renderer.post_init();
const int k_size = 32;
olive::VideoParams params(k_size, k_size, olive::PixelFormat::u8,
olive::VideoParams::k_rgba_channel_count);
olive::TexturePtr src = renderer.create_texture(params);
ASSERT_NE(src, nullptr);
ASSERT_FALSE(src->is_dummy());
QByteArray src_data(k_size * k_size * 4, 0);
for (int i = 0; i < k_size * k_size; ++i) {
src_data[i * 4 + 0] = static_cast<char>(255);
src_data[i * 4 + 3] = static_cast<char>(255);
}
src->upload(src_data.data(), k_size);
const QString vert =
QStringLiteral("uniform mat4 ove_mvpmat;\n"
"in vec4 a_position;\n"
"in vec2 a_texcoord;\n"
"out vec2 ove_texcoord;\n"
"void main() {\n"
" gl_Position = ove_mvpmat * a_position;\n"
" ove_texcoord = a_texcoord;\n"
"}\n");
const QString frag =
QStringLiteral("uniform sampler2D ove_maintex;\n"
"in vec2 ove_texcoord;\n"
"out vec4 frag_color;\n"
"void main() {\n"
" frag_color = texture(ove_maintex, ove_texcoord);\n"
"}\n");
QVariant shader =
renderer.create_native_shader(olive::ShaderCode(frag, vert));
ASSERT_FALSE(shader.isNull());
olive::ShaderJob job;
job.insert(QStringLiteral("ove_maintex"),
olive::NodeValue(olive::NodeValue::k_texture,
QVariant::fromValue(src)));
job.insert(QStringLiteral("ove_mvpmat"),
olive::NodeValue(olive::NodeValue::k_matrix, QMatrix4x4()));
// Null-destination Blit has no render target; it should simply not crash.
renderer.blit(shader, job, params, true);
SUCCEED();
#endif
}
// Verifies iterative shader support: the first pass writes to a temporary
// texture and the second pass samples it before writing the final destination.
TEST(DynamicRenderBackend, VulkanIterativeBlitPingPong)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind != oak_render_backend_vulkan) {
GTEST_SKIP() << "Vulkan backend is not available on this system";
}
ASSERT_TRUE(renderer.init());
renderer.post_init();
const int k_size = 32;
olive::VideoParams params(k_size, k_size, olive::PixelFormat::u8,
olive::VideoParams::k_rgba_channel_count);
olive::TexturePtr src = renderer.create_texture(params);
ASSERT_NE(src, nullptr);
ASSERT_FALSE(src->is_dummy());
// Start with a fully red texture.
QByteArray src_data(k_size * k_size * 4, 0);
for (int i = 0; i < k_size * k_size; ++i) {
src_data[i * 4 + 0] = static_cast<char>(255);
src_data[i * 4 + 3] = static_cast<char>(255);
}
src->upload(src_data.data(), k_size);
olive::TexturePtr dst = renderer.create_texture(params);
ASSERT_NE(dst, nullptr);
ASSERT_FALSE(dst->is_dummy());
// Shader that samples the iterative input and scales RGB by 0.5 each pass.
const QString vert =
QStringLiteral("uniform mat4 ove_mvpmat;\n"
"in vec4 a_position;\n"
"in vec2 a_texcoord;\n"
"out vec2 ove_texcoord;\n"
"void main() {\n"
" gl_Position = ove_mvpmat * a_position;\n"
" ove_texcoord = a_texcoord;\n"
"}\n");
const QString frag =
QStringLiteral("uniform sampler2D ove_maintex;\n"
"in vec2 ove_texcoord;\n"
"out vec4 frag_color;\n"
"void main() {\n"
" vec4 c = texture(ove_maintex, ove_texcoord);\n"
" frag_color = vec4(c.rgb * 0.5, c.a);\n"
"}\n");
QVariant shader =
renderer.create_native_shader(olive::ShaderCode(frag, vert));
ASSERT_FALSE(shader.isNull());
olive::ShaderJob job;
job.insert(QStringLiteral("ove_maintex"),
olive::NodeValue(olive::NodeValue::k_texture,
QVariant::fromValue(src)));
job.insert(QStringLiteral("ove_mvpmat"),
olive::NodeValue(olive::NodeValue::k_matrix, QMatrix4x4()));
job.set_iterations(2, QStringLiteral("ove_maintex"));
renderer.blit_to_texture(shader, job, dst.get(), true);
QByteArray dst_data(k_size * k_size * 4, 0);
dst->download(dst_data.data(), k_size);
// After two halving passes, red is 255 * 0.5 * 0.5. UNORM conversion may
// floor (63) or round-to-nearest (64) depending on the driver (llvmpipe
// rounds); both are spec-conformant.
const uint8_t red = static_cast<uint8_t>(dst_data[0]);
EXPECT_TRUE(red == 63u || red == 64u) << "red = " << int(red);
EXPECT_EQ(static_cast<uint8_t>(dst_data[1]), 0u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[2]), 0u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[3]), 255u);
#endif
}
// Verifies RGB upload/download when the Vulkan driver stores the texture in a
// wider renderable format such as RGBA.
TEST(DynamicRenderBackend, VulkanUploadDownloadThreeChannel)
{
#ifndef OAK_ENABLE_DYNAMIC_RENDER_BACKEND
GTEST_SKIP() << "Dynamic render backend is not enabled in this build";
#else
olive::DynamicRenderer renderer(QStringLiteral("vulkan"));
if (!renderer.load()) {
GTEST_SKIP()
<< "vulkan backend library could not be loaded in this environment";
}
OakRenderBackendInfo info = {};
ASSERT_TRUE(renderer.get_backend_info(&info));
if (info.kind != oak_render_backend_vulkan) {
GTEST_SKIP() << "Vulkan backend is not available on this system";
}
ASSERT_TRUE(renderer.init());
renderer.post_init();
const int k_size = 16;
olive::VideoParams params(k_size, k_size, olive::PixelFormat::u8,
olive::VideoParams::k_rgb_channel_count);
olive::TexturePtr tex = renderer.create_texture(params);
ASSERT_NE(tex, nullptr);
ASSERT_FALSE(tex->is_dummy());
QByteArray src_data(k_size * k_size * 3, 0);
for (int i = 0; i < k_size * k_size; ++i) {
src_data[i * 3 + 0] = static_cast<char>(255);
src_data[i * 3 + 1] = static_cast<char>(128);
src_data[i * 3 + 2] = static_cast<char>(64);
}
tex->upload(src_data.data(), k_size);
QByteArray dst_data(k_size * k_size * 3, 0);
tex->download(dst_data.data(), k_size);
EXPECT_EQ(static_cast<uint8_t>(dst_data[0]), 255u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[1]), 128u);
EXPECT_EQ(static_cast<uint8_t>(dst_data[2]), 64u);
#endif
}