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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
/*
* Copyright 2011-2013 Blender Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#pragma once
#include "render/buffers.h"
#include "util/util_image.h"
#include "util/util_string.h"
#include "util/util_unique_ptr.h"
CCL_NAMESPACE_BEGIN
class DenoiseParams;
class Scene;
/* --------------------------------------------------------------------
* Tile.
*/
class Tile {
public:
int x = 0, y = 0;
int width = 0, height = 0;
Tile()
{
}
};
/* --------------------------------------------------------------------
* Tile Manager.
*/
class TileManager {
public:
/* This callback is invoked by whenever on-dist tiles storage file is closed after writing. */
function<void(string_view)> full_buffer_written_cb;
TileManager();
~TileManager();
TileManager(const TileManager &other) = delete;
TileManager(TileManager &&other) noexcept = delete;
TileManager &operator=(const TileManager &other) = delete;
TileManager &operator=(TileManager &&other) = delete;
/* Reset current progress and start new rendering of the full-frame parameters in tiles of the
* given size.
* Only touches scheduling-related state of the tile manager. */
/* TODO(sergey): Consider using tile area instead of exact size to help dealing with extreme
* cases of stretched renders. */
void reset_scheduling(const BufferParams ¶ms, int2 tile_size);
/* Update for the known buffer passes and scene parameters.
* Will store all parameters needed for buffers access outside of the scene graph. */
void update(const BufferParams ¶ms, const Scene *scene);
inline int get_num_tiles() const
{
return tile_state_.num_tiles;
}
inline bool has_multiple_tiles() const
{
return tile_state_.num_tiles > 1;
}
bool next();
bool done();
const Tile &get_current_tile() const;
/* Write render buffer of a tile to a file on disk.
*
* Opens file for write when first tile is written.
*
* Returns true on success. */
bool write_tile(const RenderBuffers &tile_buffers);
/* Inform the tile manager that no more tiles will be written to disk.
* The file will be considered final, all handles to it will be closed. */
void finish_write_tiles();
/* Check whether any tile ahs been written to disk. */
inline bool has_written_tiles() const
{
return write_state_.num_tiles_written != 0;
}
/* Read full frame render buffer from tiles file on disk.
*
* Returns true on success. */
bool read_full_buffer_from_disk(string_view filename,
RenderBuffers *buffers,
DenoiseParams *denoise_params);
protected:
/* Get tile configuration for its index.
* The tile index must be within [0, state_.tile_state_). */
Tile get_tile_for_index(int index) const;
bool open_tile_output();
bool close_tile_output();
/* Part of an on-disk tile file name which avoids conflicts between several Cycles instances or
* several sessions. */
string tile_file_unique_part_;
int2 tile_size_ = make_int2(0, 0);
BufferParams buffer_params_;
/* Tile scheduling state. */
struct {
int num_tiles_x = 0;
int num_tiles_y = 0;
int num_tiles = 0;
int next_tile_index;
Tile current_tile;
} tile_state_;
/* State of tiles writing to a file on disk. */
struct {
/* Index of a tile file used during the current session.
* This number is used for the file name construction, making it possible to render several
* scenes throughout duration of the session and keep all results available for later read
* access. */
int tile_file_index = 0;
string filename;
/* Specification of the tile image which corresponds to the buffer parameters.
* Contains channels configured according to the passes configuration in the path traces.
*
* Output images are saved using this specification, input images are expected to have matched
* specification. */
ImageSpec image_spec;
/* Output handle for the tile file.
*
* This file can not be closed until all tiles has been provided, so the handle is stored in
* the state and is created whenever writing is requested. */
unique_ptr<ImageOutput> tile_out;
int num_tiles_written = 0;
} write_state_;
};
CCL_NAMESPACE_END
|
