45b46e5de9
Currently we mostly iterate buffer areas using x/y loops or through utility methods extending from base classes. To simplify code in simple operations this commit adds wrappers for specifying buffer areas and their iterators for raw buffers with any element stride: - BufferRange: Specifies a range of contiguous buffer elements from a given element index. - BufferRangeIterator: Iterates elements in a BufferRange. - BufferArea: Specifies a rectangle area of elements in a 2D buffer. - BufferAreaIterator: Iterates elements in a BufferArea. - BuffersIterator: Simultaneously iterates an area of elements in an output buffer and any number of input buffers. - BuffersIteratorBuilder: Helper for building BuffersIterator adding buffers one by one. For iterating areas coordinates it adds `XRange` and `YRange` methods that return `IndexRange`. Reviewed By: jbakker Differential Revision: https://developer.blender.org/D11882
136 lines
3.3 KiB
C++
136 lines
3.3 KiB
C++
/*
|
|
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* Copyright 2011, Blender Foundation.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_index_range.hh"
|
|
#include "BLI_rect.h"
|
|
|
|
namespace blender::compositor {
|
|
|
|
enum class eExecutionModel {
|
|
/**
|
|
* Operations are executed from outputs to inputs grouped in execution groups and rendered
|
|
* in tiles.
|
|
*/
|
|
Tiled,
|
|
/** Operations are fully rendered in order from inputs to outputs. */
|
|
FullFrame
|
|
};
|
|
|
|
/**
|
|
* \brief possible data types for sockets
|
|
* \ingroup Model
|
|
*/
|
|
enum class DataType {
|
|
/** \brief Value data type */
|
|
Value = 0,
|
|
/** \brief Vector data type */
|
|
Vector = 1,
|
|
/** \brief Color data type */
|
|
Color = 2,
|
|
};
|
|
|
|
/**
|
|
* Utility to get the number of channels of the given data type.
|
|
*/
|
|
constexpr int COM_data_type_num_channels(const DataType datatype)
|
|
{
|
|
switch (datatype) {
|
|
case DataType::Value:
|
|
return 1;
|
|
case DataType::Vector:
|
|
return 3;
|
|
case DataType::Color:
|
|
default:
|
|
return 4;
|
|
}
|
|
}
|
|
|
|
constexpr int COM_DATA_TYPE_VALUE_CHANNELS = COM_data_type_num_channels(DataType::Value);
|
|
constexpr int COM_DATA_TYPE_VECTOR_CHANNELS = COM_data_type_num_channels(DataType::Vector);
|
|
constexpr int COM_DATA_TYPE_COLOR_CHANNELS = COM_data_type_num_channels(DataType::Color);
|
|
|
|
constexpr float COM_VECTOR_ZERO[3] = {0.0f, 0.0f, 0.0f};
|
|
constexpr float COM_VALUE_ZERO[1] = {0.0f};
|
|
constexpr float COM_VALUE_ONE[1] = {1.0f};
|
|
|
|
/**
|
|
* Utility to get data type for given number of channels.
|
|
*/
|
|
constexpr DataType COM_num_channels_data_type(const int num_channels)
|
|
{
|
|
switch (num_channels) {
|
|
case 1:
|
|
return DataType::Value;
|
|
case 3:
|
|
return DataType::Vector;
|
|
case 4:
|
|
default:
|
|
return DataType::Color;
|
|
}
|
|
}
|
|
|
|
// configurable items
|
|
|
|
// chunk size determination
|
|
|
|
// chunk order
|
|
/**
|
|
* \brief The order of chunks to be scheduled
|
|
* \ingroup Execution
|
|
*/
|
|
enum class ChunkOrdering {
|
|
/** \brief order from a distance to centerX/centerY */
|
|
CenterOut = 0,
|
|
/** \brief order randomly */
|
|
Random = 1,
|
|
/** \brief no ordering */
|
|
TopDown = 2,
|
|
/** \brief experimental ordering with 9 hot-spots. */
|
|
RuleOfThirds = 3,
|
|
|
|
Default = ChunkOrdering::CenterOut,
|
|
};
|
|
|
|
constexpr float COM_PREVIEW_SIZE = 140.f;
|
|
constexpr float COM_RULE_OF_THIRDS_DIVIDER = 100.0f;
|
|
constexpr float COM_BLUR_BOKEH_PIXELS = 512;
|
|
|
|
constexpr IndexRange XRange(const rcti &area)
|
|
{
|
|
return IndexRange(area.xmin, area.xmax - area.xmin);
|
|
}
|
|
|
|
constexpr IndexRange YRange(const rcti &area)
|
|
{
|
|
return IndexRange(area.ymin, area.ymax - area.ymin);
|
|
}
|
|
|
|
constexpr IndexRange XRange(const rcti *area)
|
|
{
|
|
return XRange(*area);
|
|
}
|
|
|
|
constexpr IndexRange YRange(const rcti *area)
|
|
{
|
|
return YRange(*area);
|
|
}
|
|
|
|
} // namespace blender::compositor
|