mirror of
https://github.com/qgis/QGIS.git
synced 2025-04-12 00:06:43 -04:00
e6c2ecd9f3
Fixes several crashes and problems with backwards compatibility. Before expressions were allowed, field names were loaded and saved unquoted, e.g. x.y - with introduction of expressions it was necessary to use properly quoted "x.y" name so that expression is correctly parsed. With these changes both options are possible and when possible, the unquoted field name is used for compatibility
246 lines
13 KiB
Plaintext
246 lines
13 KiB
Plaintext
class QgsSymbolLayerV2Utils
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgssymbollayerv2utils.h>
|
|
%End
|
|
|
|
public:
|
|
|
|
static QString encodeColor( QColor color );
|
|
static QColor decodeColor( QString str );
|
|
|
|
static QString encodeSldAlpha( int alpha );
|
|
static int decodeSldAlpha( QString str );
|
|
|
|
static QString encodeSldFontStyle( QFont::Style style );
|
|
static QFont::Style decodeSldFontStyle( QString str );
|
|
|
|
static QString encodeSldFontWeight( int weight );
|
|
static int decodeSldFontWeight( QString str );
|
|
|
|
static QString encodePenStyle( Qt::PenStyle style );
|
|
static Qt::PenStyle decodePenStyle( QString str );
|
|
|
|
static QString encodePenJoinStyle( Qt::PenJoinStyle style );
|
|
static Qt::PenJoinStyle decodePenJoinStyle( QString str );
|
|
|
|
static QString encodePenCapStyle( Qt::PenCapStyle style );
|
|
static Qt::PenCapStyle decodePenCapStyle( QString str );
|
|
|
|
static QString encodeSldLineJoinStyle( Qt::PenJoinStyle style );
|
|
static Qt::PenJoinStyle decodeSldLineJoinStyle( QString str );
|
|
|
|
static QString encodeSldLineCapStyle( Qt::PenCapStyle style );
|
|
static Qt::PenCapStyle decodeSldLineCapStyle( QString str );
|
|
|
|
static QString encodeBrushStyle( Qt::BrushStyle style );
|
|
static Qt::BrushStyle decodeBrushStyle( QString str );
|
|
|
|
static QString encodeSldBrushStyle( Qt::BrushStyle style );
|
|
static Qt::BrushStyle decodeSldBrushStyle( QString str );
|
|
|
|
static QString encodePoint( QPointF point );
|
|
static QPointF decodePoint( QString str );
|
|
|
|
static QString encodeRealVector( const QVector<qreal>& v );
|
|
static QVector<qreal> decodeRealVector( const QString& s );
|
|
|
|
static QString encodeSldRealVector( const QVector<qreal>& v );
|
|
static QVector<qreal> decodeSldRealVector( const QString& s );
|
|
|
|
static QString encodeOutputUnit( QgsSymbolV2::OutputUnit unit );
|
|
static QgsSymbolV2::OutputUnit decodeOutputUnit( QString str );
|
|
|
|
static QString encodeSldUom( QgsSymbolV2::OutputUnit unit, double *scaleFactor );
|
|
static QgsSymbolV2::OutputUnit decodeSldUom( QString str, double *scaleFactor );
|
|
|
|
static QString encodeScaleMethod( QgsSymbolV2::ScaleMethod scaleMethod );
|
|
static QgsSymbolV2::ScaleMethod decodeScaleMethod( QString str );
|
|
|
|
static QIcon symbolPreviewIcon( QgsSymbolV2* symbol, QSize size );
|
|
static QIcon symbolLayerPreviewIcon( QgsSymbolLayerV2* layer, QgsSymbolV2::OutputUnit u, QSize size );
|
|
static QIcon colorRampPreviewIcon( QgsVectorColorRampV2* ramp, QSize size );
|
|
|
|
static void drawStippledBackround( QPainter* painter, QRect rect );
|
|
|
|
static QPixmap symbolPreviewPixmap( QgsSymbolV2* symbol, QSize size );
|
|
static QPixmap colorRampPreviewPixmap( QgsVectorColorRampV2* ramp, QSize size );
|
|
|
|
/**Returns the maximum estimated bleed for the symbol */
|
|
static double estimateMaxSymbolBleed( QgsSymbolV2* symbol );
|
|
|
|
static QgsSymbolV2* loadSymbol( QDomElement& element ) /Factory/;
|
|
static QgsSymbolLayerV2* loadSymbolLayer( QDomElement& element ) /Factory/;
|
|
static QDomElement saveSymbol( QString symbolName, QgsSymbolV2* symbol, QDomDocument& doc );
|
|
|
|
static bool createSymbolLayerV2ListFromSld( QDomElement& element, QGis::GeometryType geomType, QgsSymbolLayerV2List &layers );
|
|
|
|
static QgsSymbolLayerV2* createFillLayerFromSld( QDomElement &element );
|
|
static QgsSymbolLayerV2* createLineLayerFromSld( QDomElement &element );
|
|
static QgsSymbolLayerV2* createMarkerLayerFromSld( QDomElement &element );
|
|
|
|
static bool convertPolygonSymbolizerToPointMarker( QDomElement &element, QgsSymbolLayerV2List &layerList );
|
|
static bool hasExternalGraphic( QDomElement &element );
|
|
static bool hasWellKnownMark( QDomElement &element );
|
|
|
|
static bool needFontMarker( QDomElement &element );
|
|
static bool needSvgMarker( QDomElement &element );
|
|
static bool needEllipseMarker( QDomElement &element );
|
|
static bool needMarkerLine( QDomElement &element );
|
|
static bool needLinePatternFill( QDomElement &element );
|
|
static bool needPointPatternFill( QDomElement &element );
|
|
static bool needSvgFill( QDomElement &element );
|
|
|
|
static void fillToSld( QDomDocument &doc, QDomElement &element,
|
|
Qt::BrushStyle brushStyle, QColor color = QColor() );
|
|
static bool fillFromSld( QDomElement &element,
|
|
Qt::BrushStyle &brushStyle, QColor &color );
|
|
|
|
//! @note not available in python bindings
|
|
/*
|
|
static void lineToSld( QDomDocument &doc, QDomElement &element,
|
|
Qt::PenStyle penStyle, QColor color, double width = -1,
|
|
const Qt::PenJoinStyle *penJoinStyle = 0, const Qt::PenCapStyle *penCapStyle = 0,
|
|
const QVector<qreal> *customDashPattern = 0, double dashOffset = 0.0 );
|
|
*/
|
|
static bool lineFromSld( QDomElement &element,
|
|
Qt::PenStyle &penStyle, QColor &color, double &width,
|
|
Qt::PenJoinStyle *penJoinStyle = 0, Qt::PenCapStyle *penCapStyle = 0,
|
|
QVector<qreal> *customDashPattern = 0, double *dashOffset = 0 );
|
|
|
|
static void externalGraphicToSld( QDomDocument &doc, QDomElement &element,
|
|
QString path, QString mime,
|
|
QColor color, double size = -1 );
|
|
static bool externalGraphicFromSld( QDomElement &element,
|
|
QString &path, QString &mime,
|
|
QColor &color, double &size );
|
|
|
|
/** @deprecated Use wellKnownMarkerToSld( QDomDocument &doc, QDomElement &element, QString name, QColor color, QColor borderColor, Qt::PenStyle borderStyle, double borderWidth, double size ) instead */
|
|
static void wellKnownMarkerToSld( QDomDocument &doc, QDomElement &element,
|
|
QString name, QColor color, QColor borderColor = QColor(),
|
|
double borderWidth = -1, double size = -1 ) /Deprecated/ ;
|
|
static void wellKnownMarkerToSld( QDomDocument &doc, QDomElement &element,
|
|
QString name, QColor color, QColor borderColor, Qt::PenStyle borderStyle,
|
|
double borderWidth = -1, double size = -1 );
|
|
/** @deprecated Use wellKnownMarkerFromSld( QDomElement &element, QString &name, QColor &color, QColor &borderColor, Qt::PenStyle &borderStyle, double &borderWidth, double &size ) instead */
|
|
static bool wellKnownMarkerFromSld( QDomElement &element,
|
|
QString &name, QColor &color, QColor &borderColor,
|
|
double &borderWidth, double &size ) /Deprecated/ ;
|
|
static bool wellKnownMarkerFromSld( QDomElement &element,
|
|
QString &name, QColor &color, QColor &borderColor, Qt::PenStyle &borderStyle,
|
|
double &borderWidth, double &size ) /PyName=wellKnownMarkerFromSld2/ ;
|
|
|
|
static void externalMarkerToSld( QDomDocument &doc, QDomElement &element,
|
|
QString path, QString format, int *markIndex = 0,
|
|
QColor color = QColor(), double size = -1 );
|
|
static bool externalMarkerFromSld( QDomElement &element,
|
|
QString &path, QString &format, int &markIndex,
|
|
QColor &color, double &size );
|
|
|
|
|
|
static void labelTextToSld( QDomDocument &doc, QDomElement &element, QString label,
|
|
QFont font, QColor color = QColor(), double size = -1 );
|
|
|
|
/**Create ogr feature style string for pen */
|
|
static QString ogrFeatureStylePen( double width, double mmScaleFactor, double mapUnitsScaleFactor, const QColor& c,
|
|
Qt::PenJoinStyle joinStyle = Qt::MiterJoin,
|
|
Qt::PenCapStyle capStyle = Qt::FlatCap,
|
|
double offset = 0.0,
|
|
const QVector<qreal>* dashPattern = 0 );
|
|
/**Create ogr feature style string for brush
|
|
@param fillColr fill color*/
|
|
static QString ogrFeatureStyleBrush( const QColor& fillColr );
|
|
|
|
static void createRotationElement( QDomDocument &doc, QDomElement &element, QString rotationFunc );
|
|
static bool rotationFromSldElement( QDomElement &element, QString &rotationFunc );
|
|
|
|
static void createOpacityElement( QDomDocument &doc, QDomElement &element, QString alphaFunc );
|
|
static bool opacityFromSldElement( QDomElement &element, QString &alphaFunc );
|
|
|
|
static void createDisplacementElement( QDomDocument &doc, QDomElement &element, QPointF offset );
|
|
static bool displacementFromSldElement( QDomElement &element, QPointF &offset );
|
|
|
|
static void createOnlineResourceElement( QDomDocument &doc, QDomElement &element, QString path, QString format );
|
|
static bool onlineResourceFromSldElement( QDomElement &element, QString &path, QString &format );
|
|
|
|
static void createGeometryElement( QDomDocument &doc, QDomElement &element, QString geomFunc );
|
|
static bool geometryFromSldElement( QDomElement &element, QString &geomFunc );
|
|
|
|
static bool createFunctionElement( QDomDocument &doc, QDomElement &element, QString function );
|
|
static bool functionFromSldElement( QDomElement &element, QString &function );
|
|
|
|
static QDomElement createSvgParameterElement( QDomDocument &doc, QString name, QString value );
|
|
static QgsStringMap getSvgParameterList( QDomElement &element );
|
|
|
|
static QDomElement createVendorOptionElement( QDomDocument &doc, QString name, QString value );
|
|
static QgsStringMap getVendorOptionList( QDomElement &element );
|
|
|
|
static QgsStringMap parseProperties( QDomElement& element );
|
|
static void saveProperties( QgsStringMap props, QDomDocument& doc, QDomElement& element );
|
|
|
|
static QgsSymbolV2Map loadSymbols( QDomElement& element ) /Factory/;
|
|
static QDomElement saveSymbols( QgsSymbolV2Map& symbols, QString tagName, QDomDocument& doc );
|
|
|
|
static void clearSymbolMap( QgsSymbolV2Map& symbols );
|
|
|
|
static QgsVectorColorRampV2* loadColorRamp( QDomElement& element ) /Factory/;
|
|
static QDomElement saveColorRamp( QString name, QgsVectorColorRampV2* ramp, QDomDocument& doc );
|
|
|
|
/** parse color definition with format "rgb(0,0,0)" or "0,0,0" */
|
|
static QColor parseColor( QString colorStr );
|
|
|
|
/**Returns the line width scale factor depending on the unit and the paint device*/
|
|
static double lineWidthScaleFactor( const QgsRenderContext& c, QgsSymbolV2::OutputUnit u );
|
|
/**Returns scale factor painter units -> pixel dimensions*/
|
|
static double pixelSizeScaleFactor( const QgsRenderContext& c, QgsSymbolV2::OutputUnit u );
|
|
/**Creates a render context for a pixel based device*/
|
|
static QgsRenderContext createRenderContext( QPainter* p );
|
|
|
|
/**Multiplies opacity of image pixel values with a (global) transparency value*/
|
|
static void multiplyImageOpacity( QImage* image, qreal alpha );
|
|
|
|
/** Blurs an image in place, e.g. creating Qt-independent drop shadows
|
|
* @note added in 1.9
|
|
*/
|
|
static void blurImageInPlace( QImage& image, const QRect& rect, int radius, bool alphaOnly );
|
|
|
|
/**Sorts the passed list in requested order*/
|
|
static void sortVariantList( QList<QVariant>& list, Qt::SortOrder order );
|
|
/**Returns a point on the line from startPoint to directionPoint that is a certain distance away from the starting point*/
|
|
static QPointF pointOnLineWithDistance( const QPointF& startPoint, const QPointF& directionPoint, double distance );
|
|
|
|
//! Return a list of all available svg files
|
|
static QStringList listSvgFiles();
|
|
|
|
//! Return a list of svg files at the specified directory
|
|
static QStringList listSvgFilesAt( QString directory );
|
|
|
|
/** Get symbol's path from its name.
|
|
* If the name is not absolute path the file is searched in SVG paths specified
|
|
* in settings svg/searchPathsForSVG.
|
|
*/
|
|
static QString symbolNameToPath( QString name );
|
|
|
|
//! Get symbols's name from its path
|
|
static QString symbolPathToName( QString path );
|
|
|
|
//! Calculate the centroid point of a QPolygonF
|
|
static QPointF polygonCentroid( const QPolygonF& points );
|
|
|
|
/** Return a new valid expression instance for given field or expression string.
|
|
* If the input is not a valid expression, it is assumed that it is a field name and gets properly quoted.
|
|
* If the string is empty, returns null pointer.
|
|
* This is useful when accepting input which could be either a non-quoted field name or expression.
|
|
* @note added in 2.2
|
|
*/
|
|
static QgsExpression* fieldOrExpressionToExpression( const QString& fieldOrExpression ) /Factory/;
|
|
|
|
/** Return a field name if the whole expression is just a name of the field .
|
|
* Returns full expression string if the expression is more complex than just one field.
|
|
* Using just expression->expression() method may return quoted field name, but that is not
|
|
* wanted for saving (due to backward compatibility) or display in GUI.
|
|
* @note added in 2.2
|
|
*/
|
|
static QString fieldOrExpressionFromExpression( QgsExpression* expression );
|
|
};
|