mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-27 00:33:48 -05:00
ef6727518d
Allows creation of snap lines at specific locations, and adjusting position of existing guides to exact coordinates
104 lines
3.4 KiB
Plaintext
104 lines
3.4 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layout/qgslayoutsnapper.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
class QgsLayoutSnapper
|
|
{
|
|
%Docstring
|
|
Manages snapping grids and preset snap lines in a layout, and handles
|
|
snapping points to the nearest grid coordinate/snap line when possible.
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgslayoutsnapper.h"
|
|
%End
|
|
public:
|
|
|
|
QgsLayoutSnapper( QgsLayout *layout );
|
|
%Docstring
|
|
Constructor for QgsLayoutSnapper, attached to the specified ``layout``.
|
|
%End
|
|
|
|
void setSnapTolerance( const int snapTolerance );
|
|
%Docstring
|
|
Sets the snap ``tolerance`` (in pixels) to use when snapping.
|
|
.. seealso:: snapTolerance()
|
|
%End
|
|
|
|
int snapTolerance() const;
|
|
%Docstring
|
|
Returns the snap tolerance (in pixels) to use when snapping.
|
|
.. seealso:: setSnapTolerance()
|
|
:rtype: int
|
|
%End
|
|
|
|
bool snapToGrid() const;
|
|
%Docstring
|
|
Returns true if snapping to grid is enabled.
|
|
.. seealso:: setSnapToGrid()
|
|
:rtype: bool
|
|
%End
|
|
|
|
void setSnapToGrid( bool enabled );
|
|
%Docstring
|
|
Sets whether snapping to grid is ``enabled``.
|
|
.. seealso:: snapToGrid()
|
|
%End
|
|
|
|
QPointF snapPoint( QPointF point, double scaleFactor, bool &snapped /Out/ ) const;
|
|
%Docstring
|
|
Snaps a layout coordinate ``point``. If ``point`` was snapped, ``snapped`` will be set to true.
|
|
|
|
The ``scaleFactor`` argument should be set to the transformation from
|
|
scalar transform from layout coordinates to pixels, i.e. the
|
|
graphics view transform().m11() value.
|
|
|
|
This method considers snapping to the grid, snap lines, etc.
|
|
:rtype: QPointF
|
|
%End
|
|
|
|
QPointF snapPointToGrid( QPointF point, double scaleFactor, bool &snapped /Out/ ) const;
|
|
%Docstring
|
|
Snaps a layout coordinate ``point`` to the grid. If ``point``
|
|
was snapped, ``snapped`` will be set to true.
|
|
|
|
The ``scaleFactor`` argument should be set to the transformation from
|
|
scalar transform from layout coordinates to pixels, i.e. the
|
|
graphics view transform().m11() value.
|
|
|
|
If snapToGrid() is disabled, this method will return the point
|
|
unchanged.
|
|
:rtype: QPointF
|
|
%End
|
|
|
|
double snapPointToGuides( double original, QgsLayoutGuide::Orientation orientation, double scaleFactor, bool &snapped /Out/ ) const;
|
|
%Docstring
|
|
Snaps a layout coordinate ``point`` to the grid. If ``point``
|
|
was snapped, ``snapped`` will be set to true.
|
|
|
|
The ``scaleFactor`` argument should be set to the transformation from
|
|
scalar transform from layout coordinates to pixels, i.e. the
|
|
graphics view transform().m11() value.
|
|
|
|
If snapToGrid() is disabled, this method will return the point
|
|
unchanged.
|
|
:rtype: float
|
|
%End
|
|
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/layout/qgslayoutsnapper.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|