Files
create/src/Mod/Part/App/AttachExtension.h
Ladislav Michl 2bb41bd1e7 Part: Fix AttachmentSupport when loading files from previous versions
Commit 6b6ff58d3c4a ("Part: Rename AttachExtension::Support property to
AttachmentSupport...") provided code to convert property name when loading
files saved with previous versions. Unfortunately a41f176f596a
("Toponaming: bring in missing code fragments in Part") was based on
at the time obsolete code which did not contain before mentioned tweak,
so AttachmentSupport ended unassigned.

Fixes: a41f176f596a ("Toponaming: bring in missing code fragments in Part")
2024-06-17 11:32:13 -05:00

261 lines
9.6 KiB
C++

/***************************************************************************
* Copyright (c) 2015 Victor Titov (DeepSOIC) <vv.titov@gmail.com> *
* *
* 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 *
* *
***************************************************************************/
/**
* AttachExtensionh, .cpp contain a extension class to derive other features from, to make
* them attachable.
*/
#ifndef PARTATTACHABLEOBJECT_H
#define PARTATTACHABLEOBJECT_H
#include <App/DocumentObjectExtension.h>
#include <App/ExtensionPython.h>
#include <App/PropertyLinks.h>
#include <App/PropertyStandard.h>
#include <Base/Exception.h>
#include <Base/Placement.h>
#include "Attacher.h"
#include "PartFeature.h"
namespace Part
{
#ifdef FC_USE_TNP_FIX
class PartExport AttachEngineException: public Base::Exception
{
public:
/// Construction
AttachEngineException();
explicit AttachEngineException(const char* sMessage);
explicit AttachEngineException(const std::string& sMessage);
/// Destruction
~AttachEngineException() throw() override
{}
};
/**
* @brief The AttachableObject class is the thing to extend an object with
* that should be attachable. It includes the required properties, and
* shortcuts for accessing the attachment math class.
*/
class PartExport AttachExtension: public App::DocumentObjectExtension
{
EXTENSION_PROPERTY_HEADER_WITH_OVERRIDE(Part::AttachableObject);
public:
AttachExtension();
~AttachExtension() override;
/**
* @brief setAttacher sets the AttachEngine object. The class takes the
* ownership of the pointer, it will be deleted when the class is
* destroyed, or when a new attacher is set. The default attacher is AttachEngine3D.
* @param attacher. AttachableObject takes ownership and will delete it eventually.
*/
virtual void setAttacher(Attacher::AttachEngine* attacher, bool base = false);
/**
* @brief changeAttacherType
* @param typeName is the typename of new attacher class. Must be derived
* from Attacher::AttachEngine.
* @return true if attacher was changed. false if attacher is already of the
* type requested. Throws if invalid type is supplied.
*/
bool changeAttacherType(const char* typeName, bool base = false);
Attacher::AttachEngine& attacher(bool base = false) const;
App::PropertyString AttacherType;
App::PropertyEnumeration AttacherEngine;
App::PropertyLinkSubList AttachmentSupport;
App::PropertyEnumeration MapMode; // see AttachEngine::eMapMode
App::PropertyBool MapReversed; // inverts Z and X internal axes
App::PropertyPlacement AttachmentOffset;
/**
* @brief MapPathParameter is a parameter value for mmNormalToPath (the
* sketch will be mapped normal to a curve at point specified by parameter
* (from 0.0 to 1.0, from start to end) )
*/
App::PropertyFloat MapPathParameter;
/** calculate and update the Placement property based on the Support, and
* mode. Can throw FreeCAD and OCC exceptions. Returns true if attached,
* false if not, throws if attachment failed.
*/
virtual bool positionBySupport();
/** Return whether this attacher is active
*/
bool isAttacherActive() const;
virtual bool isTouched_Mapping()
{
return true; /*support.isTouched isn't true when linked objects are changed... why?..*/
}
short int extensionMustExecute() override;
App::DocumentObjectExecReturn* extensionExecute() override;
PyObject* getExtensionPyObject() override;
void onExtendedDocumentRestored() override;
struct Properties
{
App::PropertyString* attacherType = nullptr;
App::PropertyLinkSubList* attachment = nullptr;
App::PropertyEnumeration* mapMode = nullptr;
App::PropertyBool* mapReversed = nullptr;
App::PropertyFloat* mapPathParameter = nullptr;
bool matchProperty(const App::Property* prop) const
{
return prop == attachment || prop == mapMode || prop == mapReversed
|| prop == mapPathParameter;
}
};
Properties getProperties(bool base) const;
Properties getInitedProperties(bool base);
protected:
void extensionOnChanged(const App::Property* /*prop*/) override;
virtual bool extensionHandleChangedPropertyName(Base::XMLReader& reader,
const char* TypeName,
const char* PropName) override;
App::PropertyPlacement& getPlacement() const;
void initBase(bool force);
public:
void updateAttacherVals(bool base = false) const;
void updatePropertyStatus(bool attached, bool base = false);
private:
struct _Properties: Properties
{
mutable std::unique_ptr<Attacher::AttachEngine> attacher;
};
_Properties _props;
_Properties _baseProps;
mutable int _active = -1;
};
using AttachExtensionPython = App::ExtensionPythonT<AttachExtension>;
#else
class PartExport AttachEngineException : public Base::Exception
{
public:
/// Construction
AttachEngineException();
explicit AttachEngineException(const char * sMessage);
explicit AttachEngineException(const std::string& sMessage);
/// Destruction
~AttachEngineException() noexcept override = default;
};
/**
* @brief The AttachableObject class is the thing to extend an object with
* that should be attachable. It includes the required properties, and
* shortcuts for accessing the attachment math class.
*/
class PartExport AttachExtension : public App::DocumentObjectExtension
{
EXTENSION_PROPERTY_HEADER_WITH_OVERRIDE(Part::AttachableObject);
public:
AttachExtension();
~AttachExtension() override;
/**
* @brief setAttacher sets the AttachEngine object. The class takes the
* ownership of the pointer, it will be deleted when the class is
* destroyed, or when a new attacher is set. The default attacher is AttachEngine3D.
* @param attacher. AttachableObject takes ownership and will delete it eventually.
*/
virtual void setAttacher(Attacher::AttachEngine* attacher);
/**
* @brief changeAttacherType
* @param typeName is the typename of new attacher class. Must be derived
* from Attacher::AttachEngine.
* @return true if attacher was changed. false if attacher is already of the
* type requested. Throws if invalid type is supplied.
*/
bool changeAttacherType(const char* typeName);
Attacher::AttachEngine &attacher() const {if(!_attacher) throw AttachEngineException("AttachableObject: no attacher is set."); return *_attacher;}
App::PropertyString AttacherType;
App::PropertyLinkSubList AttachmentSupport;
App::PropertyEnumeration MapMode; //see AttachEngine::eMapMode
App::PropertyBool MapReversed; //inverts Z and X internal axes
App::PropertyPlacement AttachmentOffset;
/**
* @brief MapPathParameter is a parameter value for mmNormalToPath (the
* sketch will be mapped normal to a curve at point specified by parameter
* (from 0.0 to 1.0, from start to end) )
*/
App::PropertyFloat MapPathParameter;
/** calculate and update the Placement property based on the AttachmentSupport, and
* mode. Can throw FreeCAD and OCC exceptions. Returns true if attached,
* false if not, throws if attachment failed.
*/
virtual bool positionBySupport();
/** Return whether this attacher is active
*/
bool isAttacherActive() const;
virtual bool isTouched_Mapping()
{return true; /*AttachmentSupport.isTouched isn't true when linked objects are changed... why?..*/}
short int extensionMustExecute() override;
App::DocumentObjectExecReturn *extensionExecute() override;
PyObject* getExtensionPyObject() override;
void onExtendedDocumentRestored() override;
protected:
void extensionOnChanged(const App::Property* /*prop*/) override;
virtual bool extensionHandleChangedPropertyName(Base::XMLReader &reader, const char * TypeName, const char *PropName) override;
App::PropertyPlacement& getPlacement() const;
public:
void updateAttacherVals();
private:
Attacher::AttachEngine* _attacher = nullptr;
mutable int _active = -1;
};
using AttachExtensionPython = App::ExtensionPythonT<AttachExtension>;
#endif
} // namespace Part
#endif // PARTATTACHABLEOBJECT_H