qgslegendsettings.cpp

Go to the documentation of this file.

/***************************************************************************
  qgslegendsettings.cpp
  --------------------------------------
  Date                 : July 2014
  Copyright            : (C) 2014 by Martin Dobias
  Email                : wonder dot sk at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program 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 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#include "qgslegendsettings.h"
#include "qgsexpressioncontext.h"
#include "qgsexpression.h"
#include "qgsrendercontext.h"
 
#include <QPainter>
 
QgsLegendSettings::QgsLegendSettings()
  : mSymbolSize( 7, 4 )
  , mWmsLegendSize( 50, 25 )
  , mRasterStrokeColor( Qt::black )
{
  mStyleMap.resize( static_cast< int >( Qgis::LegendComponent::SymbolLabel ) + 1 );
 
  rstyle( Qgis::LegendComponent::Title ).setMargin( QgsLegendStyle::Bottom, 3.5 );
  rstyle( Qgis::LegendComponent::Group ).setMargin( QgsLegendStyle::Top, 3 );
  rstyle( Qgis::LegendComponent::Subgroup ).setMargin( QgsLegendStyle::Top, 3 );
  rstyle( Qgis::LegendComponent::Symbol ).setMargin( QgsLegendStyle::Top, 2.5 );
  rstyle( Qgis::LegendComponent::SymbolLabel ).setMargin( QgsLegendStyle::Top, 2 );
  rstyle( Qgis::LegendComponent::SymbolLabel ).setMargin( QgsLegendStyle::Left, 2 );
  rstyle( Qgis::LegendComponent::Group ).setIndent( 0.0 );
  rstyle( Qgis::LegendComponent::Subgroup ).setIndent( 0.0 );
 
  QgsTextFormat f = rstyle( Qgis::LegendComponent::Title ).textFormat();
  f.setSize( 16.0 );
  f.setSizeUnit( Qgis::RenderUnit::Points );
  // these default line heights are not ideal, but needed to maintain api
  f.setLineHeight( 1.1 );
  f.setLineHeightUnit( Qgis::RenderUnit::Percentage );
  rstyle( Qgis::LegendComponent::Title ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::Group ).textFormat();
  f.setSize( 14.0 );
  f.setSizeUnit( Qgis::RenderUnit::Points );
  f.setLineHeight( 1.1 );
  f.setLineHeightUnit( Qgis::RenderUnit::Percentage );
  rstyle( Qgis::LegendComponent::Group ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::Subgroup ).textFormat();
  f.setSize( 12.0 );
  f.setSizeUnit( Qgis::RenderUnit::Points );
  f.setLineHeight( 1.1 );
  f.setLineHeightUnit( Qgis::RenderUnit::Percentage );
  rstyle( Qgis::LegendComponent::Subgroup ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::SymbolLabel ).textFormat();
  f.setSize( 12.0 );
  f.setSizeUnit( Qgis::RenderUnit::Points );
  f.setLineHeight( 1.1 );
  f.setLineHeightUnit( Qgis::RenderUnit::Percentage );
  rstyle( Qgis::LegendComponent::SymbolLabel ).setTextFormat( f );
}
QgsLegendSettings::QgsLegendSettings() {…}
 
void QgsLegendSettings::updateDataDefinedProperties( QgsRenderContext &context )
{
  rstyle( Qgis::LegendComponent::Title ).updateDataDefinedProperties( context );
  rstyle( Qgis::LegendComponent::Group ).updateDataDefinedProperties( context );
  rstyle( Qgis::LegendComponent::Subgroup ).updateDataDefinedProperties( context );
  rstyle( Qgis::LegendComponent::SymbolLabel ).updateDataDefinedProperties( context );
}
void QgsLegendSettings::updateDataDefinedProperties( QgsRenderContext &context ) {…}
 
QColor QgsLegendSettings::fontColor() const
{
  return style( Qgis::LegendComponent::SymbolLabel ).textFormat().color();
}
QColor QgsLegendSettings::fontColor() const {…}
 
void QgsLegendSettings::setFontColor( const QColor &c )
{
  rstyle( Qgis::LegendComponent::Title ).textFormat().setColor( c );
  rstyle( Qgis::LegendComponent::Group ).textFormat().setColor( c );
  rstyle( Qgis::LegendComponent::Subgroup ).textFormat().setColor( c );
  rstyle( Qgis::LegendComponent::SymbolLabel ).textFormat().setColor( c );
}
void QgsLegendSettings::setFontColor( const QColor &c ) {…}
 
QColor QgsLegendSettings::layerFontColor() const
{
  return style( Qgis::LegendComponent::Subgroup ).textFormat().color();
}
QColor QgsLegendSettings::layerFontColor() const {…}
 
void QgsLegendSettings::setLayerFontColor( const QColor &fontColor )
{
  rstyle( Qgis::LegendComponent::Group ).textFormat().setColor( fontColor );
  rstyle( Qgis::LegendComponent::Subgroup ).textFormat().setColor( fontColor );
}
void QgsLegendSettings::setLayerFontColor( const QColor &fontColor ) {…}
 
void QgsLegendSettings::setLineSpacing( double s ) SIP_DEPRECATED
{
  // line spacing *was* a fixed amount (in mm) added between each line of text.
  mLineSpacing = s;
 
  QgsTextFormat f = rstyle( Qgis::LegendComponent::Title ).textFormat();
  // assume font sizes in points, since that was what we always had from before this method was deprecated
  f.setLineHeight( f.size() * 0.352778 + s );
  f.setLineHeightUnit( Qgis::RenderUnit::Millimeters );
  rstyle( Qgis::LegendComponent::Title ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::Group ).textFormat();
  f.setLineHeight( f.size() * 0.352778 + s );
  f.setLineHeightUnit( Qgis::RenderUnit::Millimeters );
  rstyle( Qgis::LegendComponent::Group ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::Subgroup ).textFormat();
  f.setLineHeight( f.size() * 0.352778 + s );
  f.setLineHeightUnit( Qgis::RenderUnit::Millimeters );
  rstyle( Qgis::LegendComponent::Subgroup ).setTextFormat( f );
 
  f = rstyle( Qgis::LegendComponent::SymbolLabel ).textFormat();
  f.setLineHeight( f.size() * 0.352778 + s );
  f.setLineHeightUnit( Qgis::RenderUnit::Millimeters );
  rstyle( Qgis::LegendComponent::SymbolLabel ).setTextFormat( f );
}
void QgsLegendSettings::setLineSpacing( double s ) SIP_DEPRECATED {…}
 
double QgsLegendSettings::mmPerMapUnit() const
{
  return mMmPerMapUnit;
}
double QgsLegendSettings::mmPerMapUnit() const {…}
 
void QgsLegendSettings::setMmPerMapUnit( double mmPerMapUnit )
{
  mMmPerMapUnit = mmPerMapUnit;
}
void QgsLegendSettings::setMmPerMapUnit( double mmPerMapUnit ) {…}
 
bool QgsLegendSettings::useAdvancedEffects() const
{
  return mUseAdvancedEffects;
}
bool QgsLegendSettings::useAdvancedEffects() const {…}
 
void QgsLegendSettings::setUseAdvancedEffects( bool use )
{
  mUseAdvancedEffects = use;
}
void QgsLegendSettings::setUseAdvancedEffects( bool use ) {…}
 
double QgsLegendSettings::mapScale() const
{
  return mMapScale;
}
double QgsLegendSettings::mapScale() const {…}
 
void QgsLegendSettings::setMapScale( double scale )
{
  mMapScale = scale;
}
void QgsLegendSettings::setMapScale( double scale ) {…}
 
double QgsLegendSettings::mapUnitsPerPixel() const
{
  return 1 / ( mMmPerMapUnit * ( mDpi / 25.4 ) );
}
double QgsLegendSettings::mapUnitsPerPixel() const {…}
 
void QgsLegendSettings::setMapUnitsPerPixel( double mapUnitsPerPixel )
{
  mMmPerMapUnit = 1 / mapUnitsPerPixel / ( mDpi / 25.4 );
}
void QgsLegendSettings::setMapUnitsPerPixel( double mapUnitsPerPixel ) {…}
 
int QgsLegendSettings::dpi() const
{
  return mDpi;
}
int QgsLegendSettings::dpi() const {…}
 
void QgsLegendSettings::setDpi( int dpi )
{
  mDpi = dpi;
}
void QgsLegendSettings::setDpi( int dpi ) {…}
 
QStringList QgsLegendSettings::evaluateItemText( const QString &text, const QgsExpressionContext &context ) const
{
  const QString textToRender = QgsExpression::replaceExpressionText( text, &context );
  return splitStringForWrapping( textToRender );
}
QStringList QgsLegendSettings::evaluateItemText( const QString &text, const QgsExpressionContext &context ) const {…}
 
QStringList QgsLegendSettings::splitStringForWrapping( const QString &stringToSplit ) const
{
  const QStringList lines = stringToSplit.split( '\n' );
 
  // If the string contains nothing then just return the string without splitting.
  if ( wrapChar().isEmpty() )
    return lines;
 
  QStringList res;
  for ( const QString &line : lines )
  {
    res.append( line.split( wrapChar() ) );
  }
  return res;
}
QStringList QgsLegendSettings::splitStringForWrapping( const QString &stringToSplit ) const {…}
 
#define FONT_WORKAROUND_SCALE 10 //scale factor for upscaling fontsize and downscaling painter
 
 
void QgsLegendSettings::drawText( QPainter *p, double x, double y, const QString &text, const QFont &font ) const
{
  const QFont textFont = scaledFontPixelSize( font );
 
  const QgsScopedQPainterState painterState( p );
  p->setFont( textFont );
  const double scaleFactor = 1.0 / FONT_WORKAROUND_SCALE;
  p->scale( scaleFactor, scaleFactor );
  p->drawText( QPointF( x * FONT_WORKAROUND_SCALE, y * FONT_WORKAROUND_SCALE ), text );
}
void QgsLegendSettings::drawText( QPainter *p, double x, double y, const QString &text, const QFont &font ) const {…}
 
 
void QgsLegendSettings::drawText( QPainter *p, const QRectF &rect, const QString &text, const QFont &font, Qt::AlignmentFlag halignment, Qt::AlignmentFlag valignment, int flags ) const
{
  const QFont textFont = scaledFontPixelSize( font );
 
  const QRectF scaledRect( rect.x() * FONT_WORKAROUND_SCALE, rect.y() * FONT_WORKAROUND_SCALE,
                           rect.width() * FONT_WORKAROUND_SCALE, rect.height() * FONT_WORKAROUND_SCALE );
 
  const QgsScopedQPainterState painterState( p );
  p->setFont( textFont );
  const double scaleFactor = 1.0 / FONT_WORKAROUND_SCALE;
  p->scale( scaleFactor, scaleFactor );
  p->drawText( scaledRect, halignment | valignment | flags, text );
}
void QgsLegendSettings::drawText( QPainter *p, const QRectF &rect, const QString &text, const QFont &font, Qt::AlignmentFlag halignment, Qt::AlignmentFlag valignment, int flags ) const {…}
 
 
QFont QgsLegendSettings::scaledFontPixelSize( const QFont &font ) const
{
  QFont scaledFont = font;
  const double pixelSize = pixelFontSize( font.pointSizeF() ) * FONT_WORKAROUND_SCALE + 0.5;
  scaledFont.setPixelSize( pixelSize );
  return scaledFont;
}
QFont QgsLegendSettings::scaledFontPixelSize( const QFont &font ) const {…}
 
double QgsLegendSettings::pixelFontSize( double pointSize ) const
{
  return ( pointSize * 0.3527 );
}
double QgsLegendSettings::pixelFontSize( double pointSize ) const {…}
 
double QgsLegendSettings::textWidthMillimeters( const QFont &font, const QString &text ) const
{
  const QFont metricsFont = scaledFontPixelSize( font );
  const QFontMetricsF fontMetrics( metricsFont );
  return ( fontMetrics.horizontalAdvance( text ) / FONT_WORKAROUND_SCALE );
}
double QgsLegendSettings::textWidthMillimeters( const QFont &font, const QString &text ) const {…}
 
double QgsLegendSettings::fontHeightCharacterMM( const QFont &font, QChar c ) const
{
  const QFont metricsFont = scaledFontPixelSize( font );
  const QFontMetricsF fontMetrics( metricsFont );
  return ( fontMetrics.boundingRect( c ).height() / FONT_WORKAROUND_SCALE );
}
double QgsLegendSettings::fontHeightCharacterMM( const QFont &font, QChar c ) const {…}
 
double QgsLegendSettings::fontAscentMillimeters( const QFont &font ) const
{
  const QFont metricsFont = scaledFontPixelSize( font );
  const QFontMetricsF fontMetrics( metricsFont );
  return ( fontMetrics.ascent() / FONT_WORKAROUND_SCALE );
}
double QgsLegendSettings::fontAscentMillimeters( const QFont &font ) const {…}
 
double QgsLegendSettings::fontDescentMillimeters( const QFont &font ) const
{
  const QFont metricsFont = scaledFontPixelSize( font );
  const QFontMetricsF fontMetrics( metricsFont );
  return ( fontMetrics.descent() / FONT_WORKAROUND_SCALE );
}
double QgsLegendSettings::fontDescentMillimeters( const QFont &font ) const {…}
 
Qgis::LegendJsonRenderFlags QgsLegendSettings::jsonRenderFlags() const
{
  return mJsonRenderFlags;
}
Qgis::LegendJsonRenderFlags QgsLegendSettings::jsonRenderFlags() const {…}
 
void QgsLegendSettings::setJsonRenderFlags( const Qgis::LegendJsonRenderFlags &jsonRenderFlags )
{
  mJsonRenderFlags = jsonRenderFlags;
}
void QgsLegendSettings::setJsonRenderFlags( const Qgis::LegendJsonRenderFlags &jsonRenderFlags ) {…}