Jacques Lucke
f5ce243a56
This patch refactors the instance-realization code and adds new functionality. * Named and anonymous attributes are propagated from instances to the realized geometry. If the same attribute exists on the geometry and on an instance, the attribute on the geometry has precedence. * The id attribute has special handling to avoid creating the same id on many output points. This is necessary to make e.g. the Random Value node work as expected afterwards. Realizing instance attributes has an effect on existing files, especially due to the id attribute. To avoid breaking existing files, the Realize Instances node now has a legacy option that is enabled for all already existing Realize Instances nodes. Removing this legacy behavior does affect some existing files (although not many). We can decide whether it's worth to remove the old behavior as a separate step. This refactor also improves performance when realizing instances. That is mainly due to multi-threading. See D13446 to get the file used for benchmarking. The curve code is not as optimized as it could be yet. That's mainly because the storage for these attributes might change soonish and it wasn't worth optimizing for the current storage format right now. ``` 1,000,000 x mesh vertex: 530 ms -> 130 ms 1,000,000 x simple cube: 1290 ms -> 190 ms 1,000,000 x point: 1000 ms -> 150 ms 1,000,000 x curve spiral: 1740 ms -> 330 ms 1,000,000 x curve line: 1110 ms -> 210 ms 10,000 x subdivided cylinder: 170 ms -> 40 ms 10 x subdivided spiral: 180 ms -> 180 ms ``` Differential Revision: https://developer.blender.org/D13446
72 lines
2.9 KiB
C++
72 lines
2.9 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.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "BKE_geometry_set.hh"
|
|
|
|
namespace blender::bke {
|
|
|
|
/**
|
|
* \note This doesn't extract instances from the "dupli" system for non-geometry-nodes instances.
|
|
*/
|
|
GeometrySet object_get_evaluated_geometry_set(const Object &object);
|
|
|
|
/**
|
|
* Used to keep track of a group of instances using the same geometry data.
|
|
*/
|
|
struct GeometryInstanceGroup {
|
|
/**
|
|
* The geometry set instanced on each of the transforms. The components are not necessarily
|
|
* owned here. For example, they may be owned by the instanced object. This cannot be a
|
|
* reference because not all instanced data will necessarily have a #geometry_set_eval.
|
|
*/
|
|
GeometrySet geometry_set;
|
|
|
|
/**
|
|
* As an optimization to avoid copying, the same geometry set can be associated with multiple
|
|
* instances. Each instance is stored as a transform matrix here. Again, these must be owned
|
|
* because they may be transformed from the original data. TODO: Validate that last statement.
|
|
*/
|
|
Vector<float4x4> transforms;
|
|
};
|
|
|
|
/**
|
|
* Return flattened vector of the geometry component's recursive instances. I.e. all collection
|
|
* instances and object instances will be expanded into the instances of their geometry components.
|
|
* Even the instances in those geometry components' will be included.
|
|
*
|
|
* \note For convenience (to avoid duplication in the caller), the returned vector also contains
|
|
* the argument geometry set.
|
|
*
|
|
* \note This doesn't extract instances from the "dupli" system for non-geometry-nodes instances.
|
|
*/
|
|
void geometry_set_gather_instances(const GeometrySet &geometry_set,
|
|
Vector<GeometryInstanceGroup> &r_instance_groups);
|
|
|
|
/**
|
|
* Add information about all the attributes on every component of the type. The resulting info
|
|
* will contain the highest complexity data type and the highest priority domain among every
|
|
* attribute with the given name on all of the input components.
|
|
*/
|
|
void geometry_set_gather_instances_attribute_info(
|
|
Span<GeometryInstanceGroup> set_groups,
|
|
Span<GeometryComponentType> component_types,
|
|
const Set<std::string> &ignored_attributes,
|
|
Map<AttributeIDRef, AttributeKind> &r_attributes);
|
|
|
|
} // namespace blender::bke
|