valentina/src/app/puzzle/vplayout.h

312 lines
9.1 KiB
C
Raw Normal View History

2020-04-13 18:58:16 +02:00
/************************************************************************
**
2020-05-23 15:34:11 +02:00
** @file vplayout.h
2020-04-13 18:58:16 +02:00
** @author Ronan Le Tiec
** @date 13 4, 2020
**
** @brief
** @copyright
** This source code is part of the Valentina project, a pattern making
** program, whose allow create and modeling patterns of clothing.
** Copyright (C) 2020 Valentina project
** <https://gitlab.com/smart-pattern/valentina> All Rights Reserved.
**
** Valentina is free software: you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation, either version 3 of the License, or
** (at your option) any later version.
**
** Valentina 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 Valentina. If not, see <http://www.gnu.org/licenses/>.
**
*************************************************************************/
2020-05-23 15:34:11 +02:00
#ifndef VPLAYOUT_H
#define VPLAYOUT_H
2020-04-13 18:58:16 +02:00
2020-04-13 18:58:16 +02:00
#include <QList>
2020-04-13 18:58:16 +02:00
#include "def.h"
2020-05-23 15:29:57 +02:00
class VPPieceList;
2020-05-23 15:42:51 +02:00
class VPPiece;
class VPSheet;
2020-04-13 18:58:16 +02:00
2020-05-23 15:34:11 +02:00
class VPLayout : public QObject
2020-04-13 18:58:16 +02:00
{
Q_OBJECT
2020-04-13 18:58:16 +02:00
public:
2020-05-23 15:34:11 +02:00
VPLayout();
virtual ~VPLayout();
2020-04-13 18:58:16 +02:00
2020-05-23 15:29:57 +02:00
/**
* @brief GetUnplacedPieceList Returns the piece list of unplaced pieces
* @return the unplaced pieces list
*/
VPPieceList* GetUnplacedPieceList();
2020-04-13 18:58:16 +02:00
/**
* @brief GetTrashPieceList Returns the piece list of the trash
* @return the pieces list of trashed pieces.
*/
VPPieceList* GetTrashPieceList();
VPSheet* AddSheet();
VPSheet* AddSheet(VPSheet *sheet);
QList<VPSheet *> GetSheets();
2020-04-13 18:58:16 +02:00
2020-05-05 17:40:36 +02:00
/**
* @brief GetSelectedPieces Returns the list of the selected pieces
* @return the selected pieces
*/
2020-05-23 15:42:51 +02:00
QList<VPPiece *> GetSelectedPieces();
2020-05-05 17:40:36 +02:00
/**
* @brief SetUnit Sets the unit of the layout to the given unit
* @param unit the new unit
*/
2020-04-13 18:58:16 +02:00
void SetUnit(Unit unit);
2020-05-05 17:40:36 +02:00
/**
* @brief GetUnit Returns the current unit of the layout
* @return the unit
*/
2020-04-23 14:26:24 +02:00
Unit GetUnit() const;
2020-04-13 18:58:16 +02:00
void SetWarningSuperpositionOfPieces(bool state);
2020-04-23 14:50:20 +02:00
bool GetWarningSuperpositionOfPieces() const;
2020-04-13 18:58:16 +02:00
void SetWarningPiecesOutOfBound(bool state);
2020-04-23 14:50:20 +02:00
bool GetWarningPiecesOutOfBound() const;
2020-04-13 18:58:16 +02:00
/**
* @brief SetTitle Sets the title of the layout to the given value
* @param title the title of the layout
*/
2021-05-27 10:35:39 +02:00
void SetTitle(const QString &title);
/**
* @brief GetTitle Returns the title of the layout
* @return title of the layout
*/
QString GetTitle() const;
/**
* @brief SetDescription Sets the description of the layout to the given value
* @param description the description of the layout
*/
2021-05-27 10:35:39 +02:00
void SetDescription(const QString &description);
/**
* @brief GetDescription Returns the description of the layout.
* @return description of the layout
*/
QString GetDescription() const;
/**
* @brief ClearSelection goes through the unplaced pieces and through the sheets and calls
* SetIsSelected(false) for the pieces that were selected.
*/
void ClearSelection();
2020-05-24 19:53:51 +02:00
/**
* @brief ClearSelectionExceptForPieceList same as clearSelection but it leaves the selection
* for the given piece list like it ist.
*
* @param pieceList the piece list to let be the way it is.
*/
void ClearSelectionExceptForGivenPieceList(VPPieceList* pieceList);
/**
* @brief MovePieceToPieceList Moves the given piece to the given piece list
* @param piece the piece to move
* @param pieceList the piece list to move the piece to
*/
void MovePieceToPieceList(VPPiece* piece, VPPieceList* pieceList);
/**
* @brief SetFocusedSheet Sets the focused sheet, to which pieces are added from the carrousel via drag
* and drop
* @param focusedSheet the new active sheet. If nullptr, then it sets automaticaly the first sheet from m_sheets
*/
void SetFocusedSheet(VPSheet *focusedSheet = nullptr);
/**
* @brief GetFocusedSheet Returns the focused sheet, to which pieces are added from the carrousel via drag
* and drop
* @return the focused sheet
*/
VPSheet* GetFocusedSheet();
2020-11-14 15:58:42 +01:00
/**
* @brief SetTilesSize sets the size of the tiles, the values have to be in Unit::Px
* @param width tiles width
* @param height tiles height
*/
void SetTilesSize(qreal width, qreal height);
/**
* @brief SetTilesSizeConverted sets the size of the sheet, the values have to be in the layout's unit
* @param width tiles width
* @param height tiles height
*/
void SetTilesSizeConverted(qreal width, qreal height);
/**
* @brief SetTilesSize sets the size of the tiles, the values have to be in Unit::Px
2020-11-15 12:30:29 +01:00
* @param size tiles size
2020-11-14 15:58:42 +01:00
*/
void SetTilesSize(const QSizeF &size);
/**
* @brief SetTilesSizeConverted sets the size of the tiles, the values have to be in the layout's unit
2020-11-15 12:30:29 +01:00
* @param size tiles size
2020-11-14 15:58:42 +01:00
*/
void SetTilesSizeConverted(const QSizeF &size);
/**
* @brief GetTilesSize Returns the size of the tiles in Unit::Px
2020-11-15 12:30:29 +01:00
* @return tiles size in Unit::Px
2020-11-14 15:58:42 +01:00
*/
QSizeF GetTilesSize() const;
2020-11-15 12:30:29 +01:00
/**
* @brief GetTilesSize Returns the size of the tiles in given Unit
* @return tiles size
*/
QSizeF GetTilesSize(Unit unit) const;
2020-11-14 15:58:42 +01:00
/**
* @brief GetTilesSizeConverted Returns the size of the tiles in the layout's unit
* @return the size in the layout's unit
*/
QSizeF GetTilesSizeConverted() const;
/**
* @brief GetOrientation Returns the orientation of the tiles
* @return orientation of the tiles
*/
PageOrientation GetTilesOrientation();
/**
* @brief SetOrientation Sets the orientation of the tiles to the given value
* @param orientation the new tiles orientation
*/
void SetTilesOrientation(PageOrientation orientation);
/**
* @brief SetTilesMargins, set the margins of the tiles, the values have to be in Unit::Px
* @param left in Unit::Px
* @param top in Unit::Px
* @param right in Unit::Px
* @param bottom in Unit::Px
*/
void SetTilesMargins(qreal left, qreal top, qreal right, qreal bottom);
/**
* @brief SetSheetMargins, set the margins of the tiles, the values have to be in the unit of the layout
* @param left in Unit::Px
* @param top in Unit::Px
* @param right in Unit::Px
* @param bottom in Unit::Px
*/
void SetTilesMarginsConverted(qreal left, qreal top, qreal right, qreal bottom);
/**
* @brief SetTilesMargins set the margins of the tiles, the values have to be in Unit::Px
* @param margins tiles margins
*/
void SetTilesMargins(const QMarginsF &margins);
/**
* @brief SetTilesMarginsConverted set the margins of the tiles, the values have to be in the unit of the layout
* @param margins tiles margins
*/
void SetTilesMarginsConverted(const QMarginsF &margins);
/**
* @brief GetTilesMargins Returns margins of the tiles in Unit::Px
2020-11-15 12:30:29 +01:00
* @return the margins in Unit::Px
2020-11-14 15:58:42 +01:00
*/
QMarginsF GetTilesMargins() const;
2020-11-15 12:30:29 +01:00
/**
* @brief GetTilesMargins Returns margins of the tiles in the given unit
* @param unit the unit in which we want the margins
* @return the margins in the given unit
*/
QMarginsF GetTilesMargins(Unit unit) const;
2020-11-14 15:58:42 +01:00
/**
* @brief GetTilesMarginsConverted Returns the margins of the tiles in the layout's unit
* @return the margins in the tiles's unit
*/
QMarginsF GetTilesMarginsConverted() const;
/**
* @brief GetShowTiles Returns true if the tiles has to be shown on the current sheet
* @return true if the tiles has to be shown on the current sheet
2020-11-14 15:58:42 +01:00
*/
bool GetShowTiles();
/**
* @brief SetShowTiles Sets wether to show the tiles on the current sheet or not
* @param value true to show the tiles
*/
void SetShowTiles(bool value);
signals:
2020-05-23 15:42:51 +02:00
void PieceMovedToPieceList(VPPiece *piece, VPPieceList *pieceListBefore, VPPieceList *pieceListAfter);
2020-04-13 18:58:16 +02:00
private:
2020-05-23 15:34:11 +02:00
Q_DISABLE_COPY(VPLayout)
2020-05-23 15:29:57 +02:00
VPPieceList *m_unplacedPieceList;
/**
* @brief m_trashPieceList Holds the pieces that were deleted
*/
VPPieceList *m_trashPieceList;
2020-04-13 18:58:16 +02:00
2021-05-27 10:35:39 +02:00
QList<VPSheet*> m_sheets{};
VPSheet *m_focusedSheet{nullptr};
2020-04-13 18:58:16 +02:00
// format
Unit m_unit{Unit::Cm};
2020-04-19 11:58:43 +02:00
bool m_warningSuperpositionOfPieces{false};
bool m_warningPiecesOutOfBound{false};
QString m_title{};
QString m_description{};
2020-04-13 18:58:16 +02:00
2020-11-14 15:58:42 +01:00
/**
* @brief m_size the Size of the tiles in Unit::Px
*/
QSizeF m_tilesSize{};
/**
* @brief holds the orientation of the tiles
*/
PageOrientation m_tilesOrientation {PageOrientation::Portrait};
// margins
/**
* @brief m_margins the margins of the tiles in Unit::Px
*/
QMarginsF m_tilesMargins{};
bool m_showTiles{false};
2020-04-13 18:58:16 +02:00
};
2020-05-23 15:34:11 +02:00
#endif // VPLAYOUT_H