Add renderer texture upload contract

src/renderer_api/recording_renderer.cpp

@@ -202,6 +202,34 @@ pp::foundation::Status RecordingCommandContext::read_texture(
     return pp::foundation::Status::success();
 }
 
+pp::foundation::Status RecordingCommandContext::upload_texture(
+    ITexture2D& texture,
+    ReadbackRegion region,
+    std::span<const std::byte> rgba_or_channel_bytes) noexcept
+{
+    if (in_render_pass_) {
+        return pp::foundation::Status::invalid_argument("texture upload must be outside a render pass");
+    }
+
+    const auto desc = texture.desc();
+    const auto bytes = readback_byte_size(desc, region);
+    if (!bytes) {
+        return bytes.status();
+    }
+
+    if (rgba_or_channel_bytes.size() != bytes.value()) {
+        return pp::foundation::Status::invalid_argument("texture upload byte size does not match the region");
+    }
+
+    push_command(commands_, RecordedRenderCommand {
+        .kind = RecordedRenderCommandKind::upload_texture,
+        .texture_desc = desc,
+        .readback_region = region,
+        .upload_bytes = bytes.value(),
+    });
+    return pp::foundation::Status::success();
+}
+
 pp::foundation::Status RecordingCommandContext::capture_frame(
     IRenderTarget& target,
     IReadbackBuffer& destination) noexcept
@@ -305,6 +333,8 @@ const char* recorded_render_command_kind_name(RecordedRenderCommandKind kind) no
         return "bind_mesh";
     case RecordedRenderCommandKind::draw:
         return "draw";
+    case RecordedRenderCommandKind::upload_texture:
+        return "upload_texture";
     case RecordedRenderCommandKind::read_texture:
         return "read_texture";
     case RecordedRenderCommandKind::capture_frame:

src/renderer_api/recording_renderer.h

@@ -13,6 +13,7 @@ enum class RecordedRenderCommandKind : std::uint8_t {
     bind_shader,
     bind_mesh,
     draw,
+    upload_texture,
     read_texture,
     capture_frame,
     end_render_pass,
@@ -27,6 +28,7 @@ struct RecordedRenderCommand {
     MeshDesc mesh_desc {};
     TextureDesc texture_desc {};
     ReadbackRegion readback_region {};
+    std::uint64_t upload_bytes = 0;
     std::uint64_t readback_bytes = 0;
     std::uint64_t capture_bytes = 0;
     const char* component = "";
@@ -93,6 +95,10 @@ public:
         ITexture2D& texture,
         ReadbackRegion region,
         IReadbackBuffer& destination) noexcept override;
+    [[nodiscard]] pp::foundation::Status upload_texture(
+        ITexture2D& texture,
+        ReadbackRegion region,
+        std::span<const std::byte> rgba_or_channel_bytes) noexcept override;
     [[nodiscard]] pp::foundation::Status capture_frame(
         IRenderTarget& target,
         IReadbackBuffer& destination) noexcept override;

src/renderer_api/renderer_api.h

@@ -4,6 +4,7 @@
 
 #include <cstddef>
 #include <cstdint>
+#include <span>
 
 namespace pp::renderer {
 
@@ -126,6 +127,10 @@ public:
         ITexture2D& texture,
         ReadbackRegion region,
         IReadbackBuffer& destination) noexcept = 0;
+    [[nodiscard]] virtual pp::foundation::Status upload_texture(
+        ITexture2D& texture,
+        ReadbackRegion region,
+        std::span<const std::byte> rgba_or_channel_bytes) noexcept = 0;
     [[nodiscard]] virtual pp::foundation::Status capture_frame(
         IRenderTarget& target,
         IReadbackBuffer& destination) noexcept = 0;