18#ifndef QGSLAYOUTITEMMAPGRID_H
19#define QGSLAYOUTITEMMAPGRID_H
70 void removeGrid(
const QString &gridId );
78 void moveGridUp(
const QString &gridId );
86 void moveGridDown(
const QString &gridId );
107 QList< QgsLayoutItemMapGrid * >
asList()
const;
116 double maxGridExtension()
const;
124 void calculateMaxGridExtension(
double &top,
double &right,
double &bottom,
double &left )
const;
281 void draw( QPainter *painter )
override;
301 void setBlendMode(
const QPainter::CompositionMode mode ) { mBlendMode = mode; }
307 QPainter::CompositionMode
blendMode()
const {
return mBlendMode; }
309 bool usesAdvancedEffects()
const override;
315 double maxExtension()
const;
323 void calculateMaxExtension(
double &top,
double &right,
double &bottom,
double &left )
const;
325 void setEnabled(
bool enabled )
override;
336 void setUnits( GridUnit unit );
351 void setIntervalX(
double interval );
367 void setIntervalY(
double interval );
383 void setOffsetX(
double offset );
391 double offsetX()
const {
return mGridOffsetX; }
399 void setOffsetY(
double offset );
407 double offsetY()
const {
return mGridOffsetY; }
429 void setMinimumIntervalWidth(
double width );
451 void setMaximumIntervalWidth(
double width );
462 void setStyle( GridStyle style );
476 void setCrossLength(
const double length );
492 void setGridLineWidth(
double width );
501 void setGridLineColor(
const QColor &color );
599 Q_DECL_DEPRECATED
void setAnnotationFont(
const QFont &font )
SIP_DEPRECATED;
615 Q_DECL_DEPRECATED
void setAnnotationFontColor( const QColor &color )
SIP_DEPRECATED;
623 Q_DECL_DEPRECATED QColor annotationFontColor() const
SIP_DEPRECATED;
646 void setAnnotationDisplay( DisplayMode display, BorderSide border );
656 DisplayMode annotationDisplay( BorderSide border )
const;
663 void setAnnotationPosition( AnnotationPosition position, BorderSide side );
670 AnnotationPosition annotationPosition( BorderSide side )
const;
676 void setAnnotationFrameDistance(
const double distance );
688 void setAnnotationDirection( AnnotationDirection direction, BorderSide side );
694 void setAnnotationDirection( AnnotationDirection direction );
701 AnnotationDirection annotationDirection( BorderSide border )
const;
720 void setAnnotationExpression(
const QString &expression );
749 void setFrameDivisions( DisplayMode divisions, BorderSide side );
755 DisplayMode frameDivisions( BorderSide side )
const;
794 bool testFrameSideFlag( FrameSideFlag flag )
const;
802 void setFrameWidth(
const double width );
930 void setFrameMargin(
const double margin );
945 void setFramePenSize(
const double width );
1006 void refresh()
override;
1021 struct GridExtension
1023 GridExtension() =
default;
1026 double bottom = 0.0;
1032 void UpdateBorder(
BorderSide border,
double value )
1037 left = std::max( left, value );
1040 right = std::max( right, value );
1043 top = std::max( top, value );
1046 bottom = std::max( bottom, value );
1054 void UpdateAll(
double value )
1056 left = std::max( left, value );
1057 right = std::max( right, value );
1058 top = std::max( top, value );
1059 bottom = std::max( bottom, value );
1063 struct GridLineAnnotation
1065 BorderSide border =
Left;
1080 GridLineAnnotation startAnnotation;
1081 GridLineAnnotation endAnnotation;
1083 mutable QList< GridLine > mGridLines;
1086 mutable bool mTransformDirty =
true;
1091 double mGridIntervalX = 0.0;
1093 double mGridIntervalY = 0.0;
1095 double mGridOffsetX = 0.0;
1097 double mGridOffsetY = 0.0;
1103 int mGridAnnotationPrecision = 3;
1105 bool mShowGridAnnotation =
false;
1126 double mAnnotationFrameDistance = 1.0;
1138 QString mGridAnnotationExpressionString;
1139 mutable std::unique_ptr< QgsExpression > mGridAnnotationExpression;
1143 FrameSideFlags mGridFrameSides;
1144 double mGridFrameWidth = 2.0;
1145 double mGridFramePenThickness = 0.3;
1146 QColor mGridFramePenColor = QColor( 0, 0, 0 );
1147 QColor mGridFrameFillColor1 = Qt::white;
1148 QColor mGridFrameFillColor2 = Qt::black;
1149 double mCrossLength = 3.0;
1150 double mGridFrameMargin = 0.0;
1151 bool mRotatedTicksEnabled =
false;
1153 double mRotatedTicksMinimumAngle = 0.0;
1154 double mRotatedTicksMarginToCorner = 0.0;
1155 bool mRotatedAnnotationsEnabled =
false;
1157 double mRotatedAnnotationsMinimumAngle = 0.0;
1158 double mRotatedAnnotationsMarginToCorner = 0.0;
1160 double mMinimumIntervalWidth = 50;
1161 double mMaximumIntervalWidth = 100;
1172 std::unique_ptr< QgsLineSymbol > mGridLineSymbol;
1173 std::unique_ptr< QgsMarkerSymbol > mGridMarkerSymbol;
1177 GridUnit mGridUnit = MapUnit;
1179 QPainter::CompositionMode mBlendMode = QPainter::CompositionMode_SourceOver;
1181 mutable QList< QPair< double, QPolygonF > > mTransformedXLines;
1182 mutable QList< QPair< double, QPolygonF > > mTransformedYLines;
1183 mutable QList< QgsPointXY > mTransformedIntersections;
1184 QRectF mPrevPaintRect;
1185 mutable QPolygonF mPrevMapPolygon;
1187 bool mEvaluatedEnabled =
true;
1188 double mEvaluatedIntervalX = 0;
1189 double mEvaluatedIntervalY = 0;
1190 double mEvaluatedOffsetX = 0;
1191 double mEvaluatedOffsetY = 0;
1192 double mEvaluatedGridFrameWidth = 0;
1193 double mEvaluatedGridFrameMargin = 0;
1194 double mEvaluatedAnnotationFrameDistance = 0;
1195 double mEvaluatedCrossLength = 0;
1196 double mEvaluatedGridFrameLineThickness = 0;
1209 void updateGridLinesAnnotationsPositions()
const;
1215 void drawGridFrame( QPainter *p, GridExtension *extension =
nullptr )
const;
1230 void drawCoordinateAnnotation(
QgsRenderContext &context, GridLineAnnotation annot,
const QString &annotationString, AnnotationCoordinate coordinateType, GridExtension *extension =
nullptr )
const;
1232 QString gridAnnotationString(
double value, AnnotationCoordinate coord,
QgsExpressionContext &expressionContext )
const;
1238 int xGridLines()
const;
1244 int yGridLines()
const;
1252 void drawGridLine(
const QPolygonF &line,
QgsRenderContext &context )
const;
1258 void drawGridFrameBorder( QPainter *p, BorderSide border,
double *extension =
nullptr )
const;
1265 BorderSide borderForLineCoord( QPointF p, AnnotationCoordinate coordinateType )
const;
1270 static QList<QPolygonF> trimLinesToMap(
const QPolygonF &line,
const QgsRectangle &rect );
1272 QPolygonF scalePolygon(
const QPolygonF &polygon,
double scale )
const;
1275 void drawGridCrsTransform(
QgsRenderContext &context,
double dotsPerMM,
bool calculateLinesOnly =
false )
const;
1277 void drawGridNoTransform(
QgsRenderContext &context,
double dotsPerMM,
bool calculateLinesOnly =
false )
const;
1279 void createDefaultGridLineSymbol();
1281 void createDefaultGridMarkerSymbol();
1285 void drawGridFrameZebra( QPainter *p, GridExtension *extension =
nullptr )
const;
1287 void drawGridFrameZebraBorder( QPainter *p, BorderSide border,
double *extension =
nullptr )
const;
1289 void drawGridFrameTicks( QPainter *p, GridExtension *extension =
nullptr )
const;
1291 void drawGridFrameLine( QPainter *p, GridExtension *extension =
nullptr )
const;
1293 void calculateCrsTransformLines()
const;
1295 bool shouldShowDivisionForSide( AnnotationCoordinate coordinate, BorderSide side )
const;
1296 bool shouldShowAnnotationForSide( AnnotationCoordinate coordinate, BorderSide side )
const;
1297 bool shouldShowForDisplayMode( AnnotationCoordinate coordinate, DisplayMode mode )
const;
1298 void refreshDataDefinedProperties();
1301 double mapWidth()
const;
1303 friend class TestQgsLayoutMapGrid;
This class represents a coordinate reference system (CRS).
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
A collection of grids which is drawn above the map content in a QgsLayoutItemMap.
An individual grid which is drawn above the map content in a QgsLayoutItemMap.
QString annotationExpression() const
Returns the expression used for drawing grid annotations.
double rotatedTicksMarginToCorner() const
Gets the margin to corners (in canvas units) below which outwards facing ticks are not drawn.
GridStyle
Grid drawing style.
@ Markers
Draw markers at intersections of grid lines.
@ Cross
Draw line crosses at intersections of grid lines.
void setFrameFillColor2(const QColor &color)
Sets the second fill color used for the grid frame.
GridUnit
Unit for grid values.
@ CM
Grid units in centimeters.
@ MM
Grid units in millimeters.
@ DynamicPageSizeBased
Dynamically sized, based on a on-page size range.
@ MapUnit
Grid units follow map units.
GridStyle style() const
Returns the grid's style, which controls how the grid is drawn over the map's contents.
FrameSideFlag
Flags for controlling which side of the map a frame is drawn on.
void setAnnotationFormat(const AnnotationFormat format)
Sets the format for drawing grid annotations.
double frameWidth() const
Gets the grid frame width in layout units.
double crossLength() const
Retrieves the length (in layout units) of the cross segments drawn for the grid.
void setRotatedTicksMinimumAngle(const double angle)
Sets the minimum angle (in degrees) below which ticks are not drawn.
QPainter::CompositionMode blendMode() const
Retrieves the blending mode used for drawing the grid.
void setAnnotationEnabled(const bool enabled)
Sets whether annotations should be shown for the grid.
QgsTextFormat annotationTextFormat() const
Returns the text format used when rendering grid annotations.
AnnotationFormat annotationFormat() const
Returns the format for drawing grid annotations.
double framePenSize() const
Retrieves the width of the stroke drawn in the grid frame.
void setFramePenColor(const QColor &color)
Sets the color of the stroke drawn in the grid frame.
void setRotatedTicksEnabled(const bool state)
Enable/disable ticks rotation for rotated or reprojected grids.
AnnotationPosition
Position for grid annotations.
@ OutsideMapFrame
Draw annotations outside the map frame.
TickLengthMode rotatedAnnotationsLengthMode() const
Returns the annotation length calculation mode.
double rotatedTicksMinimumAngle() const
Gets the minimum angle (in degrees) below which ticks are not drawn.
double offsetY() const
Returns the offset for grid lines in the y-direction.
AnnotationCoordinate
Annotation coordinate type.
double rotatedAnnotationsEnabled() const
Gets whether annotations rotation for rotated or reprojected grids is enabled.
void setRotatedTicksLengthMode(const TickLengthMode mode)
Sets the tick length calculation mode.
DisplayMode
Display settings for grid annotations and frames.
@ LongitudeOnly
Show longitude/x annotations/divisions only.
@ ShowAll
Show both latitude and longitude annotations/divisions.
@ LatitudeOnly
Show latitude/y annotations/divisions only.
void crsChanged()
Emitted whenever the grid's CRS is changed.
void setRotatedAnnotationsMinimumAngle(const double angle)
Sets the minimum angle (in degrees) below which annotations are not drawn.
double rotatedAnnotationsMinimumAngle() const
Gets the minimum angle (in degrees) below which annotations are not drawn.
void setAnnotationTextFormat(const QgsTextFormat &format)
Sets the text format to use when rendering grid annotations.
~QgsLayoutItemMapGrid() override
void setBlendMode(const QPainter::CompositionMode mode)
Sets the blending mode used for drawing the grid.
bool annotationEnabled() const
Returns whether annotations are shown for the grid.
void setFrameStyle(const FrameStyle style)
Sets the grid frame style.
QFlags< FrameSideFlag > FrameSideFlags
QColor framePenColor() const
Retrieves the color of the stroke drawn in the grid frame.
FrameStyle frameStyle() const
Returns the grid frame style.
void setRotatedTicksMarginToCorner(const double margin)
Sets the margin to corners (in canvas units) below which outwards facing ticks are not drawn.
QColor frameFillColor2() const
Retrieves the second fill color for the grid frame.
QgsCoordinateReferenceSystem crs() const
Retrieves the CRS for the grid.
void setRotatedAnnotationsMarginToCorner(const double margin)
Sets the margin to corners (in canvas units) below which outwards facing annotations are not drawn.
double rotatedAnnotationsMarginToCorner() const
Gets the margin to corners (in canvas units) below which outwards facing annotations are not drawn.
void setRotatedAnnotationsLengthMode(const TickLengthMode mode)
Sets the annotation length calculation mode.
TickLengthMode
Tick length mode (useful for rotated grids)
@ OrthogonalTicks
Align ticks orthogonaly.
@ NormalizedTicks
Constant tick lengths.
double offsetX() const
Returns the offset for grid lines in the x-direction.
AnnotationFormat
Format for displaying grid annotations.
@ DegreeMinuteSecondNoSuffix
Degree/minutes/seconds, use - for S/W coordinates.
@ DegreeMinuteSecondPadded
Degree/minutes/seconds, with minutes using leading zeros where required.
@ DegreeMinuteSecond
Degree/minutes/seconds, use NSEW suffix.
@ DecimalWithSuffix
Decimal degrees, use NSEW suffix.
@ DegreeMinute
Degree/minutes, use NSEW suffix.
@ DegreeMinuteNoSuffix
Degree/minutes, use - for S/W coordinates.
@ Decimal
Decimal degrees, use - for S/W coordinates.
@ DegreeMinutePadded
Degree/minutes, with minutes using leading zeros where required.
AnnotationDirection
Direction of grid annotations.
@ OnTick
Draw annotations parallel to tick (on the line)
@ Horizontal
Draw annotations horizontally.
@ Vertical
Draw annotations vertically, ascending.
@ BoundaryDirection
Annotations follow the boundary direction.
@ AboveTick
Draw annotations parallel to tick (above the line)
@ UnderTick
Draw annotations parallel to tick (under the line)
@ VerticalDescending
Draw annotations vertically, descending.
double annotationFrameDistance() const
Returns the distance between the map frame and annotations.
double intervalY() const
Returns the interval between grid lines in the y-direction.
GridUnit units() const
Returns the units used for grid measurements such as the interval and offset for grid lines.
double minimumIntervalWidth() const
Returns the minimum width (in millimeters) for grid segments.
QColor frameFillColor1() const
Retrieves the first fill color for the grid frame.
void setRotatedAnnotationsEnabled(const bool state)
Enable/disable annotations rotation for rotated or reprojected grids.
FrameStyle
Style for grid frame.
@ Zebra
Black/white pattern.
@ InteriorTicks
Tick markers drawn inside map frame.
@ LineBorder
Simple solid line frame.
@ InteriorExteriorTicks
Tick markers drawn both inside and outside the map frame.
@ LineBorderNautical
Simple solid line frame, with nautical style diagonals on corners.
@ ExteriorTicks
Tick markers drawn outside map frame.
@ NoFrame
Disable grid frame.
@ ZebraNautical
Black/white pattern, with nautical style diagonals on corners.
void setFrameFillColor1(const QColor &color)
Sets the first fill color used for the grid frame.
double frameMargin() const
Sets the grid frame Margin (in layout units).
double rotatedTicksEnabled() const
Gets whether ticks rotation for rotated or reprojected grids is enabled.
BorderSide
Border sides for annotations.
int annotationPrecision() const
Returns the coordinate precision for grid annotations, which is the number of decimal places shown wh...
double maximumIntervalWidth() const
Returns the maximum width (in millimeters) for grid segments.
TickLengthMode rotatedTicksLengthMode() const
Returns the grid frame style.
double intervalX() const
Returns the interval between grid lines in the x-direction.
A collection of map items which are drawn above the map content in a QgsLayoutItemMap.
virtual bool writeXml(QDomElement &element, QDomDocument &doc, const QgsReadWriteContext &context) const
Stores the state of the item stack in a DOM node, where element is the DOM element corresponding to a...
virtual bool readXml(const QDomElement &element, const QDomDocument &doc, const QgsReadWriteContext &context)=0
Sets the item stack's state from a DOM document, where element is a DOM node corresponding to a 'Layo...
QList< QgsLayoutItemMapItem * > asList() const
Returns a list of QgsLayoutItemMapItems contained by the stack.
QgsLayoutItemMapItem & operator[](int index)
Returns a reference to an item at the specified index within the stack.
An item which is drawn inside a QgsLayoutItemMap, e.g., a grid or map overview.
Layout graphical items for displaying a map.
A line symbol type, for rendering LineString and MultiLineString geometries.
A marker symbol type, for rendering Point and MultiPoint geometries.
The class is used as a container of context for various read/write operations on other objects.
A rectangle specified with double values.
Contains information about the context of a rendering operation.
An interface for classes which can visit style entity (e.g.
Container for all settings relating to text rendering.
double ANALYSIS_EXPORT angle(QgsPoint *p1, QgsPoint *p2, QgsPoint *p3, QgsPoint *p4)
Calculates the angle between two segments (in 2 dimension, z-values are ignored)
#define SIP_ENUM_BASETYPE(type)
Q_DECLARE_OPERATORS_FOR_FLAGS(QgsTextRendererUtils::CurvedTextFlags)
const QgsCoordinateReferenceSystem & crs