recenter_attachment()

MAYAFLUX_API void MayaFlux::Nexus::recenter_attachment	(	Attachment &	attachment,
		std::optional< glm::vec3 > &	position,
		const std::optional< glm::quat > &	orientation
	)

Read the buffer's geometry again and move the anchor to match.

The Agent stays where it is: its offset from the new anchor absorbs the difference. Blocks for a ComputeMeshBuffer, so call it off the graphics thread.

Parameters

attachment	Attachment to recenter.
position	Position of the Agent. Set if empty.
orientation	Orientation of the Agent, if it has one.

Definition at line 129 of file Attachment.cpp.

{
    const glm::quat rotation = frame(orientation);
 
    if (const auto anchor = read_anchor(attachment.buf, attachment.config.index)) {
        attachment.anchor = *anchor;
    } else {
        MF_WARN(Journal::Component::Nexus, Journal::Context::Runtime,
            "recenter kept the previous anchor: no geometry could be read from the buffer");
    }
 
    const glm::vec3 placed = glm::vec3(*attachment.transform * glm::vec4(attachment.anchor, 1.0F));
 
    if (position) {
        attachment.config.offset = glm::inverse(rotation) * (*position - placed);
    } else {
        position = placed + rotation * attachment.config.offset;
    }
    attachment.applied = *position;
}

References MayaFlux::Nexus::Attachment::anchor, MayaFlux::Nexus::Attachment::applied, MayaFlux::Nexus::Attachment::buf, MayaFlux::Nexus::Attachment::config, MayaFlux::Nexus::AttachConfig::index, MF_WARN, MayaFlux::Journal::Nexus, MayaFlux::Nexus::AttachConfig::offset, position, read_anchor(), MayaFlux::Journal::Runtime, and MayaFlux::Nexus::Attachment::transform.

Referenced by MayaFlux::Nexus::Agent::recenter(), and MayaFlux::Nexus::Emitter::recenter().

Here is the call graph for this function:

Here is the caller graph for this function: