src/Gui/Inventor/SmSwitchboard.cpp

// SPDX-License-Identifier: BSD-3-Clause

/**************************************************************************\
 * Copyright (c) Kongsberg Oil & Gas Technologies AS
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 * Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 *
 * Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 *
 * Neither the name of the copyright holder nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\**************************************************************************/

/*!
  \class SmSwitchboard SmSwitchboard.h SmallChange/nodes/SmSwitchboard.h
  \brief The SmSwitchboard class is a group node that can toggle children
  on and off arbitrarily.

  FIXME: write doc

  \ingroup nodes
*/

// FIXME: implement proper searching / SearchAction handling  2002-02-07 larsa
// FIXME: implement proper writing / WriteAction handling  2002-02-07 larsa


#include <Inventor/actions/SoCallbackAction.h>
#include <Inventor/actions/SoGetBoundingBoxAction.h>
#include <Inventor/actions/SoGetMatrixAction.h>
#include <Inventor/actions/SoGLRenderAction.h>
#include <Inventor/actions/SoHandleEventAction.h>
#include <Inventor/actions/SoPickAction.h>
#include <Inventor/actions/SoSearchAction.h>
#include <Inventor/misc/SoChildList.h>


#include "SmSwitchboard.h"


/*!
  \var SoMFBool SmSwitchboard::enable

  Selects which child to traverse during rendering (and some other)
  actions.

  When the length of this multifield is larger than the number of children
  this group has, the enable list is modulated over the children.  This lets
  you have full control over the number of times and order each child is
  traversed.

  Default enabled value is \c FALSE.
*/

// *************************************************************************

// doc in super
void SmSwitchboard::initClass()
{
    SO_NODE_INIT_CLASS(SmSwitchboard, SoGroup, SoGroup);
}

SO_NODE_SOURCE(SmSwitchboard)

/*!
  Default constructor.
*/
SmSwitchboard::SmSwitchboard()
{
    SO_NODE_CONSTRUCTOR(SmSwitchboard);

    SO_NODE_ADD_FIELD(enable, (FALSE));
}

/*!
  Constructor.

  The argument should be the approximate number of children which is
  expected to be inserted below this node. The number need not be
  exact, as it is only used as a hint for better memory resource
  allocation.
*/
SmSwitchboard::SmSwitchboard(int numchildren)
    : inherited(numchildren)
{
    SO_NODE_CONSTRUCTOR(SmSwitchboard);

    SO_NODE_ADD_FIELD(enable, (FALSE));
}

/*!
  Destructor.
*/
SmSwitchboard::~SmSwitchboard() = default;  // virtual, protected

// Documented in superclass.
void SmSwitchboard::doAction(SoAction* action)
{
    // FIXME: take PathCode and stuff into consideration...
    if (action->isOfType(SoGetBoundingBoxAction::getClassTypeId())) {
        // calculate center of bbox if bboxaction. This makes the
        // switchboard node behave exactly like a group node
        auto bbaction = (SoGetBoundingBoxAction*)action;
        // Initialize accumulation variables.
        SbVec3f acccenter(0.0f, 0.0f, 0.0f);
        int numcenters = 0;
        for (int idx = 0; idx < this->enable.getNum(); idx++) {
            const int numchildren = this->children->getLength();
            if (numchildren > 0) {
                this->children->traverse(action, (idx % numchildren));
            }
            // If center point is set, accumulate.
            if (bbaction->isCenterSet()) {
                acccenter += bbaction->getCenter();
                numcenters++;
                bbaction->resetCenter();
            }
        }
        if (numcenters != 0) {
            bbaction->setCenter(acccenter / float(numcenters), FALSE);
        }
    }
    else {  // not a GetBoundingBoxAction
        for (int idx = 0; idx < this->enable.getNum(); idx++) {
            if (this->enable[idx]) {
                const int numchildren = this->children->getLength();
                if (numchildren > 0) {
                    this->children->traverse(action, (idx % numchildren));
                }
            }
        }
    }
}

void SmSwitchboard::GLRender(SoGLRenderAction* action)
{
    SmSwitchboard::doAction((SoAction*)action);
}

void SmSwitchboard::getBoundingBox(SoGetBoundingBoxAction* action)
{
    SmSwitchboard::doAction((SoAction*)action);
}

void SmSwitchboard::getMatrix(SoGetMatrixAction* action)
{
    switch (action->getCurPathCode()) {
        case SoAction::OFF_PATH:
        case SoAction::IN_PATH:
            SmSwitchboard::doAction((SoAction*)action);
            break;
        default:
            break;
    }
}

void SmSwitchboard::callback(SoCallbackAction* action)
{
    SmSwitchboard::doAction(action);
}

// Documented in superclass.
void SmSwitchboard::pick(SoPickAction* action)
{
    SmSwitchboard::doAction((SoAction*)action);
}

// Documented in superclass.
void SmSwitchboard::handleEvent(SoHandleEventAction* action)
{
    SmSwitchboard::doAction(action);
}

void SmSwitchboard::search(SoSearchAction* action)
{
    SoNode::search(action);  // clazy:exclude=skipped-base-method
    if (action->isFound()) {
        return;
    }
    SmSwitchboard::doAction(action);
}