ff1d1cd341
DocumentObject: * getSubObject(): the most important API for Link to work with hierarchies. The function is a inspired from and replaces the getPySubObjects(). It returns a child object following a dot separated subname reference, and can optionally return accumulated transformation, and/or a python object of the refered sub-object/element. The default implementation here is to look for link type property, and search for the referenced object. This patch also include other specialized implementation of this API, such as (GeoFeature)GroupExtension (through extensionGetSubObject()), PartDesign::Body, and so on. A link type object is expected to call the linked object's getSubObject() for resolving. * getSubObjectList(): helper function to return a list of object referenced in the given subname. * getSubObjects(): return a list of subname references of all children objects. The purpose of this function is similar to ViewProvider::claimChildren(). Container type object is expected to implement this function. The reason it returns subname references instead of just object is to allow the container to skip hierarchies. For example, the Assembly3 container uses this to skip the constraint and element group. * getLinkedObject(), obtain the linked object, and optionally with the accumulated transformation. It is expected to return a linked object or the object itself if it is not a link. In case there are multiple levels of linking involved, this function allows the caller to retrieve the linked object recursively. * hasChildElement(), set/isElementVisible(), controls the children visibility for a group type object. Because the child object may be claimed by other objects, it is essential to have independent control of children visibilities. These APIs are designed to abstract how group manages the child visibility. For performance reason, these function are meant to control only the immediate child object. * resolve(), helper function to parse subname reference and resolve the final object, and optionally the immediate parent of the final object, the final object reference name (for calling `set/isElementVisible()`), and the subname reference if there is one. * touch(), add optional argument 'noRecompute' for better backward compatibility with the NoRecompute flag. By default, touch() causes recompute unless noRecompute is true * signalChanged/signalBeforeChange, two new signal for tracking changes of a specific object. * getViewProviderNameOverride(), return a string of the view provider type of this object. This allows Python class to override the view provider of an object. This feature will be used by ViewProviderLink which is designed to work with any object that has LinkBaseExtension. * canLinkProperties(), will be used by Gui::PropertyView to display linked object properties together with the object's own properties. * redirectSubname(), will be used by Gui::Tree to allow an object to redirect selection to some other object when (pre)selected in the tree view. * Visibility, new property serve as the same purpose as view provider property of the same name. It is added here so that App namespace code can check for visibility without Gui module. This is useful, for example, when constructing a compound shape of a container that respects the children visibility. * (has)hasHiddenMarker(), return or check for a special sub-element name used as marker for overriding sub-object visibility. Will be used by Gui::ViewProvider, it is put here for the same reason as adding Visibility property. * getID(), return object internal identifier. Each object is now assigned an integer identifier that is unique within its containing document. Document: * ShowHidden, new property to tell tree view whether to show hidden object items. * signalTouchedObject, new signal triggered when manually touch an object when calling its touch() function * getObjectByID(), get object by its identifier * addObject() is modified to allow overriding view provider * has/getLinksTo(), helper function to obtain links to a given object. Application: * checkLinkDepth(), helper function to check recursive depth for link traversal. The depth is checked against the total object count of all opened documents. The count (_objCount) is internally updated whenever object is added or removed. * has/getLinksTo(), same as Document::has/getLinksTo() but return links from all opened documents. GroupExtension/OriginGroupExtension/DatumFeature/DatumCS/Part::Feature: implement sepcialized getSubObject/getSubObjects().
111 lines
3.9 KiB
C++
111 lines
3.9 KiB
C++
/***************************************************************************
|
|
* Copyright (c) 2015 Stefan Tröger <stefantroeger@gmx.net> *
|
|
* *
|
|
* This file is part of the FreeCAD CAx development system. *
|
|
* *
|
|
* This library is free software; you can redistribute it and/or *
|
|
* modify it under the terms of the GNU Library General Public *
|
|
* License as published by the Free Software Foundation; either *
|
|
* version 2 of the License, or (at your option) any later version. *
|
|
* *
|
|
* This library 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 Library General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU Library General Public *
|
|
* License along with this library; see the file COPYING.LIB. If not, *
|
|
* write to the Free Software Foundation, Inc., 59 Temple Place, *
|
|
* Suite 330, Boston, MA 02111-1307, USA *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
|
|
#include "PreCompiled.h"
|
|
|
|
#ifndef _PreComp_
|
|
# include <BRepBuilderAPI_MakeFace.hxx>
|
|
# include <gp_Pln.hxx>
|
|
#endif
|
|
|
|
#include <Mod/Part/App/PartPyCXX.h>
|
|
#include <Mod/Part/App/OCCError.h>
|
|
#include "DatumCS.h"
|
|
|
|
using namespace PartDesign;
|
|
using namespace Attacher;
|
|
|
|
|
|
// ============================================================================
|
|
|
|
|
|
PROPERTY_SOURCE(PartDesign::CoordinateSystem, Part::Datum)
|
|
|
|
CoordinateSystem::CoordinateSystem()
|
|
{
|
|
this->setAttacher(new AttachEngine3D);
|
|
// Create a shape, which will be used by the Sketcher. Them main function is to avoid a dependency of
|
|
// Sketcher on the PartDesign module
|
|
BRepBuilderAPI_MakeFace builder(gp_Pln(gp_Pnt(0,0,0), gp_Dir(0,0,1)));
|
|
if (!builder.IsDone())
|
|
return;
|
|
Shape.setValue(builder.Shape());
|
|
}
|
|
|
|
CoordinateSystem::~CoordinateSystem()
|
|
{
|
|
}
|
|
|
|
Base::Vector3d CoordinateSystem::getXAxis()
|
|
{
|
|
Base::Rotation rot = Placement.getValue().getRotation();
|
|
Base::Vector3d normal;
|
|
rot.multVec(Base::Vector3d(1,0,0), normal);
|
|
return normal;
|
|
}
|
|
|
|
Base::Vector3d CoordinateSystem::getYAxis()
|
|
{
|
|
Base::Rotation rot = Placement.getValue().getRotation();
|
|
Base::Vector3d normal;
|
|
rot.multVec(Base::Vector3d(0,1,0), normal);
|
|
return normal;
|
|
}
|
|
|
|
Base::Vector3d CoordinateSystem::getZAxis()
|
|
{
|
|
Base::Rotation rot = Placement.getValue().getRotation();
|
|
Base::Vector3d normal;
|
|
rot.multVec(Base::Vector3d(0,0,1), normal);
|
|
return normal;
|
|
}
|
|
|
|
App::DocumentObject *CoordinateSystem::getSubObject(const char *subname,
|
|
PyObject **pyObj, Base::Matrix4D *pmat, bool transform, int) const
|
|
{
|
|
if(pmat && transform)
|
|
*pmat *= Placement.getValue().toMatrix();
|
|
|
|
if(!pyObj)
|
|
return const_cast<CoordinateSystem*>(this);
|
|
|
|
gp_Dir dir(0,0,1);
|
|
if(subname) {
|
|
if(strcmp(subname,"X")==0)
|
|
dir = gp_Dir(1,0,0);
|
|
else if(strcmp(subname,"Y")==0)
|
|
dir = gp_Dir(0,1,0);
|
|
}
|
|
|
|
Base::PyGILStateLocker lock;
|
|
PY_TRY {
|
|
BRepBuilderAPI_MakeFace builder(gp_Pln(gp_Pnt(0,0,0), dir));
|
|
Part::TopoShape ts(builder.Shape());
|
|
if(pmat)
|
|
ts.transformShape(*pmat,false,true);
|
|
*pyObj = Py::new_reference_to(Part::shape2pyshape(ts));
|
|
return const_cast<CoordinateSystem*>(this);
|
|
} PY_CATCH_OCC
|
|
}
|
|
|