QGIS API Documentation  3.4.15-Madeira (e83d02e274)
Public Types | Public Member Functions | Static Public Member Functions | Protected Attributes | List of all members
QgsGradientFillSymbolLayer Class Reference

#include <qgsfillsymbollayer.h>

Inheritance diagram for QgsGradientFillSymbolLayer:
Inheritance graph
[legend]

Public Types

enum  GradientColorType { SimpleTwoColor, ColorRamp }
 
enum  GradientCoordinateMode { Feature, Viewport }
 
enum  GradientSpread { Pad, Reflect, Repeat }
 
enum  GradientType { Linear, Radial, Conical }
 
- Public Types inherited from QgsSymbolLayer
enum  Property {
  PropertySize = 0, PropertyAngle, PropertyName, PropertyFillColor,
  PropertyStrokeColor, PropertyStrokeWidth, PropertyStrokeStyle, PropertyOffset,
  PropertyCharacter, PropertyWidth, PropertyHeight, PropertyPreserveAspectRatio,
  PropertyFillStyle, PropertyJoinStyle, PropertySecondaryColor, PropertyLineAngle,
  PropertyLineDistance, PropertyGradientType, PropertyCoordinateMode, PropertyGradientSpread,
  PropertyGradientReference1X, PropertyGradientReference1Y, PropertyGradientReference2X, PropertyGradientReference2Y,
  PropertyGradientReference1IsCentroid, PropertyGradientReference2IsCentroid, PropertyBlurRadius, PropertyShapeburstUseWholeShape,
  PropertyShapeburstMaxDistance, PropertyShapeburstIgnoreRings, PropertyFile, PropertyDistanceX,
  PropertyDistanceY, PropertyDisplacementX, PropertyDisplacementY, PropertyOpacity,
  PropertyCustomDash, PropertyCapStyle, PropertyPlacement, PropertyInterval,
  PropertyOffsetAlongLine, PropertyHorizontalAnchor, PropertyVerticalAnchor, PropertyLayerEnabled,
  PropertyArrowWidth, PropertyArrowStartWidth, PropertyArrowHeadLength, PropertyArrowHeadThickness,
  PropertyArrowHeadType, PropertyArrowType
}
 Data definable properties. More...
 

Public Member Functions

 QgsGradientFillSymbolLayer (const QColor &color=DEFAULT_SIMPLEFILL_COLOR, const QColor &color2=Qt::white, GradientColorType gradientColorType=SimpleTwoColor, GradientType gradientType=Linear, GradientCoordinateMode coordinateMode=Feature, GradientSpread gradientSpread=Pad)
 
 ~QgsGradientFillSymbolLayer () override
 
QgsGradientFillSymbolLayerclone () const override
 Shall be reimplemented by subclasses to create a deep copy of the instance. More...
 
QColor color2 () const
 Color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoColor. More...
 
QgsColorRampcolorRamp ()
 Returns the color ramp used for the gradient fill. More...
 
GradientCoordinateMode coordinateMode () const
 Coordinate mode for gradient. Controls how the gradient stops are positioned. More...
 
double estimateMaxBleed (const QgsRenderContext &context) const override
 Returns the estimated maximum distance which the layer style will bleed outside the drawn shape when drawn in the specified /a context. More...
 
GradientColorType gradientColorType () const
 Gradient color mode, controls how gradient color stops are created. More...
 
GradientSpread gradientSpread () const
 Gradient spread mode. Controls how the gradient behaves outside of the predefined stops. More...
 
GradientType gradientType () const
 Type of gradient, e.g., linear or radial. More...
 
QString layerType () const override
 Returns a string that represents this layer type. More...
 
QgsMapUnitScale mapUnitScale () const override
 
QPointF offset () const
 
const QgsMapUnitScaleoffsetMapUnitScale () const
 
QgsUnitTypes::RenderUnit offsetUnit () const
 
QgsUnitTypes::RenderUnit outputUnit () const override
 Returns the units to use for sizes and widths within the symbol layer. More...
 
QgsStringMap properties () const override
 Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer. More...
 
QPointF referencePoint1 () const
 
bool referencePoint1IsCentroid () const
 
QPointF referencePoint2 () const
 
bool referencePoint2IsCentroid () const
 
void renderPolygon (const QPolygonF &points, QList< QPolygonF > *rings, QgsSymbolRenderContext &context) override
 
void setColor2 (const QColor &color2)
 
void setColorRamp (QgsColorRamp *ramp)
 Sets the color ramp used for the gradient fill. More...
 
void setCoordinateMode (GradientCoordinateMode coordinateMode)
 
void setGradientColorType (GradientColorType gradientColorType)
 
void setGradientSpread (GradientSpread gradientSpread)
 
void setGradientType (GradientType gradientType)
 
void setMapUnitScale (const QgsMapUnitScale &scale) override
 
void setOffset (QPointF offset)
 Offset for gradient fill. More...
 
void setOffsetMapUnitScale (const QgsMapUnitScale &scale)
 
void setOffsetUnit (QgsUnitTypes::RenderUnit unit)
 Units for gradient fill offset. More...
 
void setOutputUnit (QgsUnitTypes::RenderUnit unit) override
 Sets the units to use for sizes and widths within the symbol layer. More...
 
void setReferencePoint1 (QPointF referencePoint)
 Starting point of gradient fill, in the range [0,0] - [1,1]. More...
 
void setReferencePoint1IsCentroid (bool isCentroid)
 Sets the starting point of the gradient to be the feature centroid. More...
 
void setReferencePoint2 (QPointF referencePoint)
 End point of gradient fill, in the range [0,0] - [1,1]. More...
 
void setReferencePoint2IsCentroid (bool isCentroid)
 Sets the end point of the gradient to be the feature centroid. More...
 
void startRender (QgsSymbolRenderContext &context) override
 
void stopRender (QgsSymbolRenderContext &context) override
 
- Public Member Functions inherited from QgsFillSymbolLayer
double angle () const
 
void drawPreviewIcon (QgsSymbolRenderContext &context, QSize size) override
 
void setAngle (double angle)
 
- Public Member Functions inherited from QgsSymbolLayer
virtual ~QgsSymbolLayer ()
 
virtual QColor color () const
 The fill color. More...
 
QgsPropertyCollectiondataDefinedProperties ()
 Returns a reference to the symbol layer's property collection, used for data defined overrides. More...
 
const QgsPropertyCollectiondataDefinedProperties () const
 Returns a reference to the symbol layer's property collection, used for data defined overrides. More...
 
virtual double dxfAngle (QgsSymbolRenderContext &context) const
 Gets angle. More...
 
virtual QColor dxfBrushColor (QgsSymbolRenderContext &context) const
 Gets brush/fill color. More...
 
virtual Qt::BrushStyle dxfBrushStyle () const
 Gets brush/fill style. More...
 
virtual QColor dxfColor (QgsSymbolRenderContext &context) const
 Gets color. More...
 
virtual QVector< qreal > dxfCustomDashPattern (QgsUnitTypes::RenderUnit &unit) const
 Gets dash pattern. More...
 
virtual double dxfOffset (const QgsDxfExport &e, QgsSymbolRenderContext &context) const
 Gets offset. More...
 
virtual Qt::PenStyle dxfPenStyle () const
 Gets pen style. More...
 
virtual double dxfWidth (const QgsDxfExport &e, QgsSymbolRenderContext &context) const
 Gets line width. More...
 
bool enabled () const
 Returns true if symbol layer is enabled and will be drawn. More...
 
virtual QColor fillColor () const
 Gets fill color. More...
 
virtual bool hasDataDefinedProperties () const
 Returns true if the symbol layer (or any of its sub-symbols) contains data defined properties. More...
 
virtual bool isCompatibleWithSymbol (QgsSymbol *symbol) const
 Returns if the layer can be used below the specified symbol. More...
 
bool isLocked () const
 
virtual QString ogrFeatureStyle (double mmScaleFactor, double mapUnitScaleFactor) const
 
QgsPaintEffectpaintEffect () const
 Returns the current paint effect for the layer. More...
 
virtual void prepareExpressions (const QgsSymbolRenderContext &context)
 Prepares all data defined property expressions for evaluation. More...
 
int renderingPass () const
 
virtual void setColor (const QColor &color)
 The fill color. More...
 
void setDataDefinedProperties (const QgsPropertyCollection &collection)
 Sets the symbol layer's property collection, used for data defined overrides. More...
 
virtual void setDataDefinedProperty (Property key, const QgsProperty &property)
 Sets a data defined property for the layer. More...
 
void setEnabled (bool enabled)
 Sets whether symbol layer is enabled and should be drawn. More...
 
virtual void setFillColor (const QColor &color)
 Set fill color. More...
 
void setLocked (bool locked)
 
void setPaintEffect (QgsPaintEffect *effect)
 Sets the current paint effect for the layer. More...
 
void setRenderingPass (int renderingPass)
 
virtual void setStrokeColor (const QColor &color)
 Set stroke color. More...
 
virtual bool setSubSymbol (QgsSymbol *symbol)
 Sets layer's subsymbol. takes ownership of the passed symbol. More...
 
virtual QColor strokeColor () const
 Gets stroke color. More...
 
virtual QgsSymbolsubSymbol ()
 Returns the symbol's sub symbol, if present. More...
 
virtual void toSld (QDomDocument &doc, QDomElement &element, const QgsStringMap &props) const
 
QgsSymbol::SymbolType type () const
 
virtual QSet< QString > usedAttributes (const QgsRenderContext &context) const
 Returns the set of attributes referenced by the layer. More...
 
virtual bool writeDxf (QgsDxfExport &e, double mmMapUnitScaleFactor, const QString &layerName, QgsSymbolRenderContext &context, QPointF shift=QPointF(0.0, 0.0)) const
 write as DXF More...
 

Static Public Member Functions

static QgsSymbolLayercreate (const QgsStringMap &properties=QgsStringMap())
 
- Static Public Member Functions inherited from QgsSymbolLayer
static const QgsPropertiesDefinitionpropertyDefinitions ()
 Returns the symbol layer property definitions. More...
 

Protected Attributes

QBrush mBrush
 
QColor mColor2
 
GradientCoordinateMode mCoordinateMode
 
GradientColorType mGradientColorType
 
QgsColorRampmGradientRamp = nullptr
 
GradientSpread mGradientSpread
 
GradientType mGradientType
 
QPointF mOffset
 
QgsMapUnitScale mOffsetMapUnitScale
 
QgsUnitTypes::RenderUnit mOffsetUnit = QgsUnitTypes::RenderMillimeters
 
QPointF mReferencePoint1
 
bool mReferencePoint1IsCentroid = false
 
QPointF mReferencePoint2
 
bool mReferencePoint2IsCentroid = false
 
QBrush mSelBrush
 
- Protected Attributes inherited from QgsFillSymbolLayer
double mAngle = 0.0
 
- Protected Attributes inherited from QgsSymbolLayer
QColor mColor
 
QgsPropertyCollection mDataDefinedProperties
 
bool mEnabled
 True if layer is enabled and should be drawn. More...
 
QgsFields mFields
 
bool mLocked
 
QgsPaintEffectmPaintEffect = nullptr
 
int mRenderingPass
 
QgsSymbol::SymbolType mType
 

Additional Inherited Members

- Protected Member Functions inherited from QgsFillSymbolLayer
 QgsFillSymbolLayer (bool locked=false)
 
void _renderPolygon (QPainter *p, const QPolygonF &points, const QList< QPolygonF > *rings, QgsSymbolRenderContext &context)
 Default method to render polygon. More...
 
- Protected Member Functions inherited from QgsSymbolLayer
 QgsSymbolLayer (QgsSymbol::SymbolType type, bool locked=false)
 
void copyDataDefinedProperties (QgsSymbolLayer *destLayer) const
 Copies all data defined properties of this layer to another symbol layer. More...
 
void copyPaintEffect (QgsSymbolLayer *destLayer) const
 Copies paint effect of this layer to another symbol layer. More...
 
void restoreOldDataDefinedProperties (const QgsStringMap &stringMap)
 Restores older data defined properties from string map. More...
 
- Static Protected Attributes inherited from QgsSymbolLayer
static const bool SELECT_FILL_BORDER = false
 Whether fill styles for selected features also highlight symbol stroke. More...
 
static const bool SELECT_FILL_STYLE = false
 Whether fill styles for selected features uses symbol layer style. More...
 
static const bool SELECTION_IS_OPAQUE = true
 Whether styles for selected features ignore symbol alpha. More...
 

Detailed Description

Definition at line 170 of file qgsfillsymbollayer.h.

Member Enumeration Documentation

Enumerator
SimpleTwoColor 
ColorRamp 

Definition at line 174 of file qgsfillsymbollayer.h.

Enumerator
Feature 
Viewport 

Definition at line 187 of file qgsfillsymbollayer.h.

Enumerator
Pad 
Reflect 
Repeat 

Definition at line 193 of file qgsfillsymbollayer.h.

Enumerator
Linear 
Radial 
Conical 

Definition at line 180 of file qgsfillsymbollayer.h.

Constructor & Destructor Documentation

QgsGradientFillSymbolLayer::QgsGradientFillSymbolLayer ( const QColor &  color = DEFAULT_SIMPLEFILL_COLOR,
const QColor &  color2 = Qt::white,
GradientColorType  gradientColorType = SimpleTwoColor,
GradientType  gradientType = Linear,
GradientCoordinateMode  coordinateMode = Feature,
GradientSpread  gradientSpread = Pad 
)

Definition at line 454 of file qgsfillsymbollayer.cpp.

QgsGradientFillSymbolLayer::~QgsGradientFillSymbolLayer ( )
override

Definition at line 468 of file qgsfillsymbollayer.cpp.

Member Function Documentation

QgsGradientFillSymbolLayer * QgsGradientFillSymbolLayer::clone ( ) const
overridevirtual

Shall be reimplemented by subclasses to create a deep copy of the instance.

Implements QgsSymbolLayer.

Definition at line 892 of file qgsfillsymbollayer.cpp.

QColor QgsGradientFillSymbolLayer::color2 ( ) const
inline

Color for endpoint of gradient, only used if the gradient color type is set to SimpleTwoColor.

Definition at line 256 of file qgsfillsymbollayer.h.

QgsColorRamp* QgsGradientFillSymbolLayer::colorRamp ( )
inline

Returns the color ramp used for the gradient fill.

This is only used if the gradient color type is set to ColorRamp.

See also
setColorRamp()
gradientColorType()

Definition at line 244 of file qgsfillsymbollayer.h.

GradientCoordinateMode QgsGradientFillSymbolLayer::coordinateMode ( ) const
inline

Coordinate mode for gradient. Controls how the gradient stops are positioned.

Definition at line 260 of file qgsfillsymbollayer.h.

QgsSymbolLayer * QgsGradientFillSymbolLayer::create ( const QgsStringMap properties = QgsStringMap())
static

Definition at line 473 of file qgsfillsymbollayer.cpp.

double QgsGradientFillSymbolLayer::estimateMaxBleed ( const QgsRenderContext context) const
overridevirtual

Returns the estimated maximum distance which the layer style will bleed outside the drawn shape when drawn in the specified /a context.

For example, polygons drawn with an stroke will draw half the width of the stroke outside of the polygon. This amount is estimated, since it may be affected by data defined symbology rules.

Reimplemented from QgsSymbolLayer.

Definition at line 910 of file qgsfillsymbollayer.cpp.

GradientColorType QgsGradientFillSymbolLayer::gradientColorType ( ) const
inline

Gradient color mode, controls how gradient color stops are created.

Definition at line 235 of file qgsfillsymbollayer.h.

GradientSpread QgsGradientFillSymbolLayer::gradientSpread ( ) const
inline

Gradient spread mode. Controls how the gradient behaves outside of the predefined stops.

Definition at line 264 of file qgsfillsymbollayer.h.

GradientType QgsGradientFillSymbolLayer::gradientType ( ) const
inline

Type of gradient, e.g., linear or radial.

Definition at line 231 of file qgsfillsymbollayer.h.

QString QgsGradientFillSymbolLayer::layerType ( ) const
overridevirtual

Returns a string that represents this layer type.

Used for serialization. Should match with the string used to register this symbol layer in the registry.

Implements QgsSymbolLayer.

Definition at line 563 of file qgsfillsymbollayer.cpp.

QgsMapUnitScale QgsGradientFillSymbolLayer::mapUnitScale ( ) const
overridevirtual

Reimplemented from QgsSymbolLayer.

Definition at line 931 of file qgsfillsymbollayer.cpp.

QPointF QgsGradientFillSymbolLayer::offset ( ) const
inline

Definition at line 285 of file qgsfillsymbollayer.h.

const QgsMapUnitScale& QgsGradientFillSymbolLayer::offsetMapUnitScale ( ) const
inline

Definition at line 292 of file qgsfillsymbollayer.h.

QgsUnitTypes::RenderUnit QgsGradientFillSymbolLayer::offsetUnit ( ) const
inline

Definition at line 289 of file qgsfillsymbollayer.h.

QgsUnitTypes::RenderUnit QgsGradientFillSymbolLayer::outputUnit ( ) const
overridevirtual

Returns the units to use for sizes and widths within the symbol layer.

Individual symbol layer subclasses will interpret this in different ways, e.g., a marker symbol layer may use it to specify the units for the marker size, while a line symbol layer may use it to specify the units for the line width.

Returns
output unit, or QgsUnitTypes::RenderUnknownUnit if the symbol layer contains mixed units
See also
setOutputUnit()

Reimplemented from QgsSymbolLayer.

Definition at line 921 of file qgsfillsymbollayer.cpp.

QgsStringMap QgsGradientFillSymbolLayer::properties ( ) const
overridevirtual

Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer.

This is used to serialize a symbol layer perstistently.

Implements QgsSymbolLayer.

Definition at line 868 of file qgsfillsymbollayer.cpp.

QPointF QgsGradientFillSymbolLayer::referencePoint1 ( ) const
inline

Definition at line 269 of file qgsfillsymbollayer.h.

bool QgsGradientFillSymbolLayer::referencePoint1IsCentroid ( ) const
inline

Definition at line 273 of file qgsfillsymbollayer.h.

QPointF QgsGradientFillSymbolLayer::referencePoint2 ( ) const
inline

Definition at line 277 of file qgsfillsymbollayer.h.

bool QgsGradientFillSymbolLayer::referencePoint2IsCentroid ( ) const
inline

Definition at line 281 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::renderPolygon ( const QPolygonF &  points,
QList< QPolygonF > *  rings,
QgsSymbolRenderContext context 
)
overridevirtual

Implements QgsFillSymbolLayer.

Definition at line 839 of file qgsfillsymbollayer.cpp.

void QgsGradientFillSymbolLayer::setColor2 ( const QColor &  color2)
inline

Definition at line 257 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setColorRamp ( QgsColorRamp ramp)

Sets the color ramp used for the gradient fill.

This is only used if the gradient color type is set to ColorRamp.

Parameters
rampcolor ramp. Ownership is transferred.
See also
colorRamp()
setGradientColorType()

Definition at line 557 of file qgsfillsymbollayer.cpp.

void QgsGradientFillSymbolLayer::setCoordinateMode ( GradientCoordinateMode  coordinateMode)
inline

Definition at line 261 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setGradientColorType ( GradientColorType  gradientColorType)
inline

Definition at line 236 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setGradientSpread ( GradientSpread  gradientSpread)
inline

Definition at line 265 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setGradientType ( GradientType  gradientType)
inline

Definition at line 232 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setMapUnitScale ( const QgsMapUnitScale scale)
overridevirtual

Reimplemented from QgsSymbolLayer.

Definition at line 926 of file qgsfillsymbollayer.cpp.

void QgsGradientFillSymbolLayer::setOffset ( QPointF  offset)
inline

Offset for gradient fill.

Definition at line 284 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setOffsetMapUnitScale ( const QgsMapUnitScale scale)
inline

Definition at line 291 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setOffsetUnit ( QgsUnitTypes::RenderUnit  unit)
inline

Units for gradient fill offset.

Definition at line 288 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setOutputUnit ( QgsUnitTypes::RenderUnit  unit)
overridevirtual

Sets the units to use for sizes and widths within the symbol layer.

Individual symbol layer subclasses will interpret this in different ways, e.g., a marker symbol layer may use it to specify the units for the marker size, while a line symbol layer may use it to specify the units for the line width.

Parameters
unitoutput units
See also
outputUnit()

Reimplemented from QgsSymbolLayer.

Definition at line 916 of file qgsfillsymbollayer.cpp.

void QgsGradientFillSymbolLayer::setReferencePoint1 ( QPointF  referencePoint)
inline

Starting point of gradient fill, in the range [0,0] - [1,1].

Definition at line 268 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setReferencePoint1IsCentroid ( bool  isCentroid)
inline

Sets the starting point of the gradient to be the feature centroid.

Definition at line 272 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setReferencePoint2 ( QPointF  referencePoint)
inline

End point of gradient fill, in the range [0,0] - [1,1].

Definition at line 276 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::setReferencePoint2IsCentroid ( bool  isCentroid)
inline

Sets the end point of the gradient to be the feature centroid.

Definition at line 280 of file qgsfillsymbollayer.h.

void QgsGradientFillSymbolLayer::startRender ( QgsSymbolRenderContext context)
overridevirtual

Implements QgsSymbolLayer.

Definition at line 826 of file qgsfillsymbollayer.cpp.

void QgsGradientFillSymbolLayer::stopRender ( QgsSymbolRenderContext context)
overridevirtual

Implements QgsSymbolLayer.

Definition at line 834 of file qgsfillsymbollayer.cpp.

Member Data Documentation

QBrush QgsGradientFillSymbolLayer::mBrush
protected

Definition at line 301 of file qgsfillsymbollayer.h.

QColor QgsGradientFillSymbolLayer::mColor2
protected

Definition at line 305 of file qgsfillsymbollayer.h.

GradientCoordinateMode QgsGradientFillSymbolLayer::mCoordinateMode
protected

Definition at line 308 of file qgsfillsymbollayer.h.

GradientColorType QgsGradientFillSymbolLayer::mGradientColorType
protected

Definition at line 304 of file qgsfillsymbollayer.h.

QgsColorRamp* QgsGradientFillSymbolLayer::mGradientRamp = nullptr
protected

Definition at line 306 of file qgsfillsymbollayer.h.

GradientSpread QgsGradientFillSymbolLayer::mGradientSpread
protected

Definition at line 309 of file qgsfillsymbollayer.h.

GradientType QgsGradientFillSymbolLayer::mGradientType
protected

Definition at line 307 of file qgsfillsymbollayer.h.

QPointF QgsGradientFillSymbolLayer::mOffset
protected

Definition at line 316 of file qgsfillsymbollayer.h.

QgsMapUnitScale QgsGradientFillSymbolLayer::mOffsetMapUnitScale
protected

Definition at line 318 of file qgsfillsymbollayer.h.

QgsUnitTypes::RenderUnit QgsGradientFillSymbolLayer::mOffsetUnit = QgsUnitTypes::RenderMillimeters
protected

Definition at line 317 of file qgsfillsymbollayer.h.

QPointF QgsGradientFillSymbolLayer::mReferencePoint1
protected

Definition at line 311 of file qgsfillsymbollayer.h.

bool QgsGradientFillSymbolLayer::mReferencePoint1IsCentroid = false
protected

Definition at line 312 of file qgsfillsymbollayer.h.

QPointF QgsGradientFillSymbolLayer::mReferencePoint2
protected

Definition at line 313 of file qgsfillsymbollayer.h.

bool QgsGradientFillSymbolLayer::mReferencePoint2IsCentroid = false
protected

Definition at line 314 of file qgsfillsymbollayer.h.

QBrush QgsGradientFillSymbolLayer::mSelBrush
protected

Definition at line 302 of file qgsfillsymbollayer.h.


The documentation for this class was generated from the following files: