Class: QgsTransformEffect

class qgis.core.QgsTransformEffect

Bases: QgsPaintEffect

A paint effect which applies transformations (such as move, scale and rotate) to a picture.

QgsTransformEffect() Constructor for QgsTransformEffect.

Methods

boundingRect

param rect:

clone

rtype:

QgsTransformEffect

create

Creates a new QgsTransformEffect effect from a properties string map.

draw

param context:

drawSource

Draws the source QPicture onto the specified painter.

fixQPictureDpi

Applies a workaround to a QPainter to avoid an issue with incorrect scaling when drawing QPictures.

imageOffset

Returns the offset which should be used when drawing the source image on to a destination render context.

properties

rtype:

Dict[str, Any]

readProperties

param props:

reflectX

Returns whether transform will be reflected along the x-axis

reflectY

Returns whether transform will be reflected along the y-axis

rotation

Returns the transform rotation, in degrees clockwise.

scaleX

Returns the x axis scaling factor.

scaleY

Returns the y axis scaling factor.

setReflectX

Sets whether to reflect along the x-axis

setReflectY

Sets whether to reflect along the y-axis

setRotation

Sets the transform rotation, in degrees clockwise.

setScaleX

Sets the x axis scaling factor.

setScaleY

Sets the y axis scaling factor.

setShearX

Sets the x axis shearing factor.

setShearY

Sets the y axis shearing factor.

setTranslateMapUnitScale

Sets the map unit scale used for the transform translation.

setTranslateUnit

Sets the units used for the transform translation.

setTranslateX

Sets the transform x translation.

setTranslateY

Sets the transform y translation.

shearX

Returns the x axis shearing factor.

shearY

Returns the y axis shearing factor.

source

Returns the source QPicture.

sourceAsImage

Returns the source QPicture rendered to a new QImage.

translateMapUnitScale

Returns the map unit scale used for the transform translation.

translateUnit

Returns the units used for the transform translation.

translateX

Returns the transform x translation.

translateY

Returns the transform y translation.

type

rtype:

str

boundingRect(self, rect: QRectF, context: QgsRenderContext) QRectF
Parameters:
Return type:

QRectF

clone(self) QgsTransformEffect
Return type:

QgsTransformEffect

create(map: Dict[str, Any]) QgsPaintEffect

Creates a new QgsTransformEffect effect from a properties string map.

Parameters:

map (Dict[str) – encoded properties string map

Return type:

QgsPaintEffect

Returns:

new QgsTransformEffect

draw(self, context: QgsRenderContext)
Parameters:

context (QgsRenderContext) –

drawSource(self, painter: QPainter)

Draws the source QPicture onto the specified painter. Handles scaling of the picture to account for the destination painter’s DPI.

Parameters:

painter – destination painter

See also

source()

See also

sourceAsImage()

fixQPictureDpi(self, painter: QPainter)

Applies a workaround to a QPainter to avoid an issue with incorrect scaling when drawing QPictures. This may need to be called by derived classes prior to rendering results onto a painter.

Parameters:

painter – destination painter

imageOffset(self, context: QgsRenderContext) QPointF

Returns the offset which should be used when drawing the source image on to a destination render context.

Parameters:

context – destination render context

Returns:

point offset for image top left corner

See also

sourceAsImage()

properties(self) Dict[str, Any]
Return type:

Dict[str, Any]

readProperties(self, props: Dict[str, Any])
Parameters:

props (Dict[str) –

reflectX(self) bool

Returns whether transform will be reflected along the x-axis

Return type:

bool

Returns:

True if transform will reflect horizontally

See also

setReflectX()

See also

reflectY()

reflectY(self) bool

Returns whether transform will be reflected along the y-axis

Return type:

bool

Returns:

True if transform will reflect horizontally

See also

setReflectY()

See also

reflectX()

rotation(self) float

Returns the transform rotation, in degrees clockwise.

See also

setRotation()

Return type:

float

scaleX(self) float

Returns the x axis scaling factor.

Return type:

float

Returns:

x axis scaling factor, where 1.0 = no scaling

See also

setScaleX()

See also

scaleY()

scaleY(self) float

Returns the y axis scaling factor.

Return type:

float

Returns:

y axis scaling factor, where 1.0 = no scaling

See also

setScaleY()

See also

scaleX()

setReflectX(self, reflectX: bool)

Sets whether to reflect along the x-axis

Parameters:

reflectX (bool) – True to reflect horizontally

See also

reflectX()

See also

setReflectY()

setReflectY(self, reflectY: bool)

Sets whether to reflect along the y-axis

Parameters:

reflectY (bool) – True to reflect horizontally

See also

reflectY()

See also

setReflectX()

setRotation(self, rotation: float)

Sets the transform rotation, in degrees clockwise.

See also

rotation()

Parameters:

rotation (float) –

setScaleX(self, scaleX: float)

Sets the x axis scaling factor.

Parameters:

scaleX (float) – factor to scale x axis by, where 1.0 = no scaling

See also

scaleX()

See also

setScaleY()

setScaleY(self, scaleY: float)

Sets the y axis scaling factor.

Parameters:

scaleY (float) – factor to scale y axis by, where 1.0 = no scaling

See also

scaleX()

setShearX(self, shearX: float)

Sets the x axis shearing factor.

Parameters:

shearX (float) – x axis shearing

See also

shearX()

See also

setShearY()

setShearY(self, shearY: float)

Sets the y axis shearing factor.

Parameters:

shearY (float) – y axis shearing

See also

shearY()

See also

setShearX()

setTranslateMapUnitScale(self, scale: QgsMapUnitScale)

Sets the map unit scale used for the transform translation.

Parameters:

scale (QgsMapUnitScale) – map unit scale for translation

See also

setTranslateX()

See also

setTranslateY()

setTranslateUnit(self, unit: Qgis.RenderUnit)

Sets the units used for the transform translation.

Parameters:

unit (Qgis.RenderUnit) – units for translation

See also

translateUnit()

See also

setTranslateX()

See also

setTranslateY()

setTranslateX(self, translateX: float)

Sets the transform x translation.

Parameters:

translateX (float) – distance to translate along the x axis

See also

translateX()

See also

setTranslateY()

setTranslateY(self, translateY: float)

Sets the transform y translation.

Parameters:

translateY (float) – distance to translate along the y axis

See also

translateY()

See also

setTranslateX()

shearX(self) float

Returns the x axis shearing factor.

Return type:

float

Returns:

x axis shearing

See also

setShearX()

See also

shearY()

shearY(self) float

Returns the y axis shearing factor.

Return type:

float

Returns:

y axis shearing

See also

setShearY()

See also

shearX()

source(self) QPicture

Returns the source QPicture. The draw() member can utilize this when drawing the effect.

Returns:

source QPicture

See also

drawSource()

See also

sourceAsImage()

sourceAsImage(self, context: QgsRenderContext) QImage

Returns the source QPicture rendered to a new QImage. The draw() member can utilize this when drawing the effect. The image will be padded or cropped from the original source QPicture by the results of the boundingRect() method. The result is cached to speed up subsequent calls to sourceAsImage.

Returns:

source QPicture rendered to an image

See also

drawSource()

See also

source()

See also

imageOffset()

See also

boundingRect()

translateMapUnitScale(self) QgsMapUnitScale

Returns the map unit scale used for the transform translation.

Return type:

QgsMapUnitScale

Returns:

map unit scale for translation

See also

translateX()

See also

translateY()

See also

translateUnit()

translateUnit(self) Qgis.RenderUnit

Returns the units used for the transform translation.

Return type:

Qgis.RenderUnit

Returns:

units for translation

See also

translateX()

See also

translateY()

translateX(self) float

Returns the transform x translation.

Return type:

float

Returns:

X distance translated along the x axis

See also

setTranslateX()

See also

translateY()

See also

translateUnit()

translateY(self) float

Returns the transform y translation.

Return type:

float

Returns:

Y distance translated along the y axis

See also

setTranslateY()

See also

translateX()

See also

translateUnit()

type(self) str
Return type:

str