SampleViewAligner Class Reference

Makes alignment of sample droped on graphics scene. More...

Collaboration diagram for SampleViewAligner:

Public Member Functions
	SampleViewAligner (DesignerScene *scene)
void	advance ()
	Applies calculated positions to views. More...
void	alignSample (const QModelIndex &parentIndex, QPointF reference={}, bool force_alignment=false)
	Aligns sample starting from reference point. More...
void	alignSample (SessionItem *item, QPointF reference={}, bool force_alignment=false)
	Aligns sample starting from. More...
void	calculateForces (IView *view)
	Calculates forces acting on single view (simplified force directed spring algorithm) and deduce new position of views. More...
void	smartAlign ()
	Spring based implified algorithm for smart alignment. More...
void	updateForces ()
	Calculates forces acting on all views for smart alignment. More...
void	updateViews (const QModelIndex &parentIndex={})
	Forms list of all views which are subject for smart alignment (i.e. More...

Private Member Functions
QList< IView * >	getConnectedViews (IView *view)
	Returns list of views connected with given view for the subsequent force calculation. More...
IView *	getViewForIndex (const QModelIndex &index)

Private Attributes
DesignerScene *	m_scene
QList< IView * >	m_views
	list of all views which are subject to smart align More...
QMap< IView *, QPointF >	m_viewToPos

Detailed Description

Makes alignment of sample droped on graphics scene.

Implements additional algorithm for smart alignment.

Definition at line 27 of file SampleViewAligner.h.

Constructor & Destructor Documentation

SampleViewAligner()

SampleViewAligner::SampleViewAligner

(

DesignerScene *

scene

)

Definition at line 33 of file SampleViewAligner.cpp.

                                                         : m_scene(scene)
{
    ASSERT(m_scene);
}

References ASSERT, and m_scene.

Member Function Documentation

advance()

void SampleViewAligner::advance

(

)

Applies calculated positions to views.

Definition at line 105 of file SampleViewAligner.cpp.

{
    for (IView* view : m_views) {
        view->setPos(m_viewToPos[view]);
    }
}

References m_views, and m_viewToPos.

Referenced by smartAlign().

alignSample() [1/2]

void SampleViewAligner::alignSample	(	const QModelIndex &	parentIndex,
		QPointF	reference = {},
		bool	force_alignment = false
	)

Aligns sample starting from reference point.

If force_alignment=false, view's position will be changed only if it has Null coordinate, if force_alignment=true the position will be changed anyway. Position of View which has parent item (like Layer) will remain unchainged.

Definition at line 161 of file SampleViewAligner.cpp.

{
    SampleModel* sampleModel = m_scene->getSampleModel();
 
    if (IView* view = getViewForIndex(parentIndex)) {
        if ((force_alignment || view->pos().isNull()) && !view->parentObject())
            view->setPos(reference);
 
        if (view->parentObject()) {
            reference = view->mapToScene(view->pos());
        } else {
            reference = view->pos();
        }
    }
    int child_counter = 0;
    for (int i_row = 0; i_row < sampleModel->rowCount(parentIndex); ++i_row) {
        QModelIndex itemIndex = sampleModel->index(i_row, 0, parentIndex);
        if (!getViewForIndex(itemIndex))
            continue;
        QPointF child_reference =
            reference + QPointF(-step_width(), step_height() * child_counter++);
        alignSample(itemIndex, child_reference, force_alignment);
    }
}

References alignSample(), DesignerScene::getSampleModel(), getViewForIndex(), SessionModel::index(), m_scene, and SessionModel::rowCount().

Here is the call graph for this function:

alignSample() [2/2]

void SampleViewAligner::alignSample	(	SessionItem *	item,
		QPointF	reference = {},
		bool	force_alignment = false
	)

Aligns sample starting from.

Definition at line 151 of file SampleViewAligner.cpp.

{
    ASSERT(item);
    alignSample(m_scene->getSampleModel()->indexOfItem(item), reference, force_alignment);
}

References ASSERT, DesignerScene::getSampleModel(), SessionModel::indexOfItem(), and m_scene.

Referenced by alignSample(), DesignerScene::alignViews(), and DesignerScene::dropEvent().

Here is the call graph for this function:

calculateForces()

void SampleViewAligner::calculateForces

(

IView *

view

)

Calculates forces acting on single view (simplified force directed spring algorithm) and deduce new position of views.

Definition at line 73 of file SampleViewAligner.cpp.

{
    qreal xvel = 0;
    qreal yvel = 0;
 
    // repulsive forces which are pushing items away
 
    double weight1(200.0);
    for (IView* other : m_views) {
        QPointF vec = view->mapToItem(other, other->boundingRect().center());
        qreal dx = view->boundingRect().center().x() - vec.x();
        qreal dy = view->boundingRect().center().y() - vec.y();
        double l = (dx * dx + dy * dy);
        if (l > 0) {
            xvel -= (dx * weight1) / l;
            yvel -= (dy * weight1) / l;
        }
    }
    // attracting forces which are pulling views together
    double weight2(100.0);
    for (IView* other : getConnectedViews(view)) {
        QPointF vec = view->mapToItem(other, other->boundingRect().center());
        qreal dx = view->boundingRect().center().x() - vec.x();
        qreal dy = view->boundingRect().center().y() - vec.y();
        xvel += dx / weight2;
        yvel += dy / weight2;
    }
    QPointF newPos = view->pos() + QPointF(xvel, yvel);
    m_viewToPos[view] = newPos;
}

References getConnectedViews(), m_views, and m_viewToPos.

Referenced by updateForces().

Here is the call graph for this function:

getConnectedViews()

QList< IView * > SampleViewAligner::getConnectedViews ( IView *  view )

private

Returns list of views connected with given view for the subsequent force calculation.

Weirdness of given function is due to the fact, that, for example, ParticleLayout view should interact not with Layer view, but with its parent - MultiLayer view. Similarly, MultiLayer is not interacting with its Layers, but directly with the ParticleLayout.

Definition at line 117 of file SampleViewAligner.cpp.

{
    QList<IView*> result;
 
    SessionItem* itemOfView = view->getItem();
 
    QList<SessionItem*> connected_items;
 
    if (itemOfView->parent()->modelType() == "Layer") {
        // e.g. we are dealing here with ParticleLayout, so we will use directly MultiLayer to
        // interact with
        connected_items.append(itemOfView->parent()->parent());
    } else {
        connected_items.append(itemOfView->parent());
    }
    if (itemOfView->modelType() == "MultiLayer") {
        // MultiLayer will not interact with its Layers, but with they children, e.g. with
        // ParticleLayouts
        for (auto child : itemOfView->children()) {
            connected_items.append(child->children().toList());
        }
    } else {
        connected_items.append(itemOfView->children().toList());
    }
    for (auto item : connected_items) {
        IView* view = m_scene->getViewForItem(item);
        if (view) {
            result.append(view);
        }
    }
    return result;
}

References SessionItem::children(), IView::getItem(), DesignerScene::getViewForItem(), m_scene, SessionItem::modelType(), and SessionItem::parent().

Referenced by calculateForces().

Here is the call graph for this function:

getViewForIndex()

IView * SampleViewAligner::getViewForIndex ( const QModelIndex &  index )

private

Definition at line 187 of file SampleViewAligner.cpp.

{
    SampleModel* sampleModel = m_scene->getSampleModel();
    SessionItem* item = sampleModel->itemForIndex(index);
    return m_scene->getViewForItem(item);
}

References DesignerScene::getSampleModel(), DesignerScene::getViewForItem(), SessionModel::itemForIndex(), and m_scene.

Referenced by alignSample(), and updateViews().

Here is the call graph for this function:

smartAlign()

void SampleViewAligner::smartAlign

(

)

Spring based implified algorithm for smart alignment.

Definition at line 39 of file SampleViewAligner.cpp.

{
    m_views.clear();
    updateViews();
    updateForces();
    advance();
}

References advance(), m_views, updateForces(), and updateViews().

Referenced by DesignerScene::onSmartAlign().

Here is the call graph for this function:

updateForces()

void SampleViewAligner::updateForces

(

)

Calculates forces acting on all views for smart alignment.

Definition at line 63 of file SampleViewAligner.cpp.

{
    m_viewToPos.clear();
    for (IView* view : m_views) {
        calculateForces(view);
    }
}

References calculateForces(), m_views, and m_viewToPos.

Referenced by smartAlign().

Here is the call graph for this function:

updateViews()

void SampleViewAligner::updateViews

(

const QModelIndex &

parentIndex = {}

)

Forms list of all views which are subject for smart alignment (i.e.

views which do not have parent view)

Definition at line 49 of file SampleViewAligner.cpp.

{
    SampleModel* sampleModel = m_scene->getSampleModel();
    for (int i_row = 0; i_row < sampleModel->rowCount(parentIndex); ++i_row) {
        QModelIndex itemIndex = sampleModel->index(i_row, 0, parentIndex);
        IView* view = getViewForIndex(itemIndex);
        if (view && !view->parentObject()) {
            m_views.append(view);
        }
        updateViews(itemIndex);
    }
}

References DesignerScene::getSampleModel(), getViewForIndex(), SessionModel::index(), m_scene, m_views, and SessionModel::rowCount().

Referenced by smartAlign().

Here is the call graph for this function:

Member Data Documentation

m_scene

DesignerScene* SampleViewAligner::m_scene

private

Definition at line 45 of file SampleViewAligner.h.

Referenced by SampleViewAligner(), alignSample(), getConnectedViews(), getViewForIndex(), and updateViews().

m_views

QList<IView*> SampleViewAligner::m_views

private

list of all views which are subject to smart align

Definition at line 46 of file SampleViewAligner.h.

Referenced by advance(), calculateForces(), smartAlign(), updateForces(), and updateViews().

m_viewToPos

QMap<IView*, QPointF> SampleViewAligner::m_viewToPos

private

Definition at line 47 of file SampleViewAligner.h.

Referenced by advance(), calculateForces(), and updateForces().

---

The documentation for this class was generated from the following files:

• /home/www/ba/GUI/coregui/Views/SampleDesigner/SampleViewAligner.h
• /home/www/ba/GUI/coregui/Views/SampleDesigner/SampleViewAligner.cpp