/**************************************************************************** ** ** This file is part of the LibreCAD project, a 2D CAD program ** ** Copyright (C) 2010 R. van Twisk (librecad@rvt.dds.nl) ** Copyright (C) 2001-2003 RibbonSoft. All rights reserved. ** ** ** This file may be distributed and/or modified under the terms of the ** GNU General Public License version 2 as published by the Free Software ** Foundation and appearing in the file gpl-2.0.txt included in the ** packaging of this file. ** ** This program 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 General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with this program; if not, write to the Free Software ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA ** ** This copyright notice MUST APPEAR in all copies of the script! ** **********************************************************************/ #ifndef RS_BLOCK_H #define RS_BLOCK_H #include "rs_document.h" /** * Holds the data that defines a block. */ struct RS_BlockData { RS_BlockData() = default; RS_BlockData(const QString& name, const RS_Vector& basePoint, bool frozen); bool isValid() const; /** * Block name. Acts as an id. */ QString name; /** * Base point of the Block. Usually 0/0 since blocks can be moved around * using the insertion point of Insert entities. */ RS_Vector basePoint; bool frozen {false}; //!< Frozen flag mutable bool visibleInBlockList {true}; //!< Visible in block list mutable bool selectedInBlockList {false}; //!< selected in block list }; /** * A block is a group of entities. A block unlike an other entity * container has a base point which defines the offset of the * block. Note that although technically possible, a block should * never be part of the entity tree of a graphic. Blocks are * stored in a separate list inside the graphic document (a block list). * The graphic can contain RS_Insert entities that refer to such * blocks. * * blocks are documents and can therefore be handled by graphic views. * * @author Andrew Mustun */ class RS_Block : public RS_Document { friend class RS_BlockList; public: /** * @param parent The graphic this block belongs to. * @param blockData defining data of the block. */ RS_Block(RS_EntityContainer* parent, const RS_BlockData& d); RS_Entity* clone() const override; /** @return RS2::EntityBlock */ RS2::EntityType rtti() const override{ return RS2::EntityBlock; } /** * @return Name of this block (the name is an Id for this block). */ QString getName() const {return data.name;} /** * @return base point of this block. */ RS_Vector getBasePoint() const {return data.basePoint;} RS_LayerList* getLayerList() override; RS_BlockList* getBlockList() override; LC_DimStylesList* getDimStyleList() override; LC_TextStyleList* getTextStyleList() override; /** * Reimplementation from RS_Document. Does nothing. */ void newDoc() override { // do nothing } friend std::ostream& operator << (std::ostream& os, const RS_Block& b); /** * sets a new name for the block. Only called by blocklist to * assure that block names stay unique. */ void setName(QString newName) { data.name = std::move(newName); } /** * @retval true if this block is frozen (invisible) * @retval false if this block isn't frozen (visible) */ bool isFrozen() const { return data.frozen; } /** * Toggles the visibility of this block. * Freezes the block if it's not frozen, thaws the block otherwise */ void toggle() { data.frozen = !data.frozen; } /** * (De-)freezes this block. * * @param freeze true: freeze, false: defreeze */ void freeze(bool freeze) { data.frozen = freeze; } /** * Sets the parent documents modified status to 'm'. */ void setModified(bool m) override; /** * Sets only this block modified status to 'm' * without touching parent document. */ void setModifiedFlag(bool m) { modified = m; } /** * Sets the visibility of the Block in block list * * @param v true: visible, false: invisible */ void visibleInBlockList(bool v); /** * Returns the visibility of the Block in block list */ bool isVisibleInBlockList() const; /** * Sets selection state of the block in block list * * @param v true: selected, false: deselected */ void selectedInBlockList(bool v) const; /** * Returns selection state of the block in block list */ bool isSelectedInBlockList() const; /** * Block may contain inserts of other blocks. * Find name of the nested block that contain the insert * of specified block. * * @param bName name of the block the nested insert references to * * @return block name chain to the block that contain searched insert */ QStringList findNestedInsert(const QString& bName); void addByBlockLine(const RS_Vector& start, const RS_Vector& end); void addByBlockEntity(RS_Entity* entity); protected: //! Block data RS_BlockData data; }; #endif