1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
// Copyright 2022 Intel Corporation
// SPDX-License-Identifier: Apache-2.0
#pragma once
#ifdef __cplusplus
namespace ispc {
#endif // __cplusplus
#if defined(__cplusplus) && !defined(OSPRAY_TARGET_SYCL)
typedef void *FrameBuffer_accumulateSampleFct;
typedef void *FrameBuffer_getRenderTaskDescFct;
typedef void *FrameBuffer_completeTaskFct;
#else
struct FrameBuffer;
struct ScreenSample;
struct RenderTaskDesc;
typedef void (*FrameBuffer_accumulateSampleFct)(FrameBuffer *uniform fb,
const varying ScreenSample &sample,
uniform RenderTaskDesc &taskDesc);
typedef uniform RenderTaskDesc (*FrameBuffer_getRenderTaskDescFct)(
FrameBuffer *uniform fb, const uniform uint32 taskID);
typedef void (*FrameBuffer_completeTaskFct)(
FrameBuffer *uniform fb, const uniform RenderTaskDesc &taskDesc);
#endif
enum FrameBufferType
{
FRAMEBUFFER_TYPE_LOCAL,
FRAMEBUFFER_TYPE_SPARSE,
FRAMEBUFFER_TYPE_UNKNOWN,
};
/* The ISPC-side FrameBuffer allows tasks to write directly to the framebuffer
* memory from ISPC. Given the set of task IDs to be rendered, a renderer must:
*
* 1. Get the RenderTaskDesc by calling getRenderTaskDesc and render the region
* of pixels specified in the task description.
*
* 2. Write the result of rendering each pixel to the framebuffer by calling
* accumulateSample
*
* 3. Update task-level values (accum ID and error) by calling completeTask
*/
struct FrameBuffer
{
FrameBufferType type;
/* Get the task description for a given render task ID. The task description
* stores the region that should be rendered for the task and its accumID
*/
FrameBuffer_getRenderTaskDescFct getRenderTaskDesc;
/* Accumulate samples taken for this render task into the framebuffer.
* Task error will also be computed and accumulated on the render task,
* to handle cases where there are more pixels in a task than the SIMD width.
*/
FrameBuffer_accumulateSampleFct accumulateSample;
/* Perform final task updates for the given task, updating its accum ID (if
* accumulation buffering is enabled) and its error if variance termination is
* enabled
*/
FrameBuffer_completeTaskFct completeTask;
// The size of the framebuffer, in pixels
vec2i size;
// 1/size (precomputed)
vec2f rcpSize;
// The default size of each each render task, in pixels
vec2i renderTaskSize;
// Rendered frame index
int32 frameID;
int32 targetFrames;
// The channels stored in the framebuffer
uint32 channels;
// If the frame has been cancelled or not. Note: we don't share bools between
// ISPC and C++ as the true value representation may differ (as it does with
// gcc)
uint32 cancelRender;
// The number of pixels rendered this frame, for tracking rendering progress
// Not used on GPU to avoid USM thrashing
uint32 numPixelsRendered;
// Variance accumulation
bool accumulateVariance; // do frame accumulation in this frame
#ifdef __cplusplus
FrameBuffer()
: type(FRAMEBUFFER_TYPE_UNKNOWN),
getRenderTaskDesc(nullptr),
accumulateSample(nullptr),
completeTask(nullptr),
size(0),
rcpSize(0.f),
renderTaskSize(4),
frameID(-1),
targetFrames(0),
channels(0),
cancelRender(0),
numPixelsRendered(0),
accumulateVariance(false)
{}
};
} // namespace ispc
#else
};
#endif // __cplusplus
|
