QBrush¶

Synopsis¶

Functions¶

def __eq__ (b)
def __ne__ (b)
def color ()
def gradient ()
def init (color, bs)
def isOpaque ()
def matrix ()
def setColor (color)
def setColor (color)
def setMatrix (mat)
def setStyle (arg__1)
def setTexture (pixmap)
def setTextureImage (image)
def setTransform (arg__1)
def style ()
def swap (other)
def texture ()
def textureImage ()
def transform ()

Detailed Description¶

The PySide.QtGui.QBrush class defines the fill pattern of shapes drawn by PySide.QtGui.QPainter .

A brush has a style, a color, a gradient and a texture.

The brush PySide.QtGui.QBrush.style() defines the fill pattern using the Qt.BrushStyle enum. The default brush style is Qt.NoBrush (depending on how you construct a brush). This style tells the painter to not fill shapes. The standard style for filling is Qt.SolidPattern . The style can be set when the brush is created using the appropriate constructor, and in addition the PySide.QtGui.QBrush.setStyle() function provides means for altering the style once the brush is constructed.

The brush PySide.QtGui.QBrush.color() defines the color of the fill pattern. The color can either be one of Qt’s predefined colors, Qt.GlobalColor , or any other custom PySide.QtGui.QColor . The currently set color can be retrieved and altered using the PySide.QtGui.QBrush.color() and PySide.QtGui.QBrush.setColor() functions, respectively.

The PySide.QtGui.QBrush.gradient() defines the gradient fill used when the current style is either Qt.LinearGradientPattern , Qt.RadialGradientPattern or Qt.ConicalGradientPattern . Gradient brushes are created by giving a PySide.QtGui.QGradient as a constructor argument when creating the PySide.QtGui.QBrush . Qt provides three different gradients: PySide.QtGui.QLinearGradient , PySide.QtGui.QConicalGradient , and PySide.QtGui.QRadialGradient - all of which inherit PySide.QtGui.QGradient .
gradient = QRadialGradient gradient(50, 50, 50, 50, 50)
gradient.setColorAt(0, QColor.fromRgbF(0, 1, 0, 1))
gradient.setColorAt(1, QColor.fromRgbF(0, 0, 0, 0))

brush = QBrush(gradient)
The PySide.QtGui.QBrush.texture() defines the pixmap used when the current style is Qt.TexturePattern . You can create a brush with a texture by providing the pixmap when the brush is created or by using PySide.QtGui.QBrush.setTexture() .

Note that applying PySide.QtGui.QBrush.setTexture() makes PySide.QtGui.QBrush.style() == Qt.TexturePattern , regardless of previous style settings. Also, calling PySide.QtGui.QBrush.setColor() will not make a difference if the style is a gradient. The same is the case if the style is Qt.TexturePattern style unless the current texture is a PySide.QtGui.QBitmap .

The PySide.QtGui.QBrush.isOpaque() function returns true if the brush is fully opaque otherwise false. A brush is considered opaque if:

The alpha component of the PySide.QtGui.QBrush.color() is 255.

Its PySide.QtGui.QBrush.texture() does not have an alpha channel and is not a PySide.QtGui.QBitmap .

The colors in the PySide.QtGui.QBrush.gradient() all have an alpha component that is 255.
To specify the style and color of lines and outlines, use the PySide.QtGui.QPainter ‘s pen combined with Qt.PenStyle and Qt.GlobalColor :
painter = QPainter(self)

painter.setBrush(Qt.cyan)
painter.setPen(Qt.darkCyan)
painter.drawRect(0, 0, 100,100)

painter.setBrush(Qt.NoBrush)
painter.setPen(Qt.darkGreen)
painter.drawRect(40, 40, 100, 100)
Note that, by default, PySide.QtGui.QPainter renders the outline (using the currently set pen) when drawing shapes. Use painter.setPen(Qt::NoPen) :attr:` <Qt.PenStyle>` to disable this behavior.
For more information about painting in general, see the Paint System .

See also

Qt.BrushStyle PySide.QtGui.QPainter PySide.QtGui.QColor

class PySide.QtGui.QBrush¶

class PySide.QtGui.QBrush(bs)

class PySide.QtGui.QBrush(color[, bs=Qt.SolidPattern])

class PySide.QtGui.QBrush(color, pixmap)

class PySide.QtGui.QBrush(brush)

class PySide.QtGui.QBrush(color[, bs=Qt.SolidPattern])

class PySide.QtGui.QBrush(color, pixmap)

class PySide.QtGui.QBrush(gradient)

class PySide.QtGui.QBrush(image)

class PySide.QtGui.QBrush(pixmap)

Parameters:	bs – `PySide.QtCore.Qt.BrushStyle` gradient – `PySide.QtGui.QGradient` brush – `PySide.QtGui.QBrush` image – `PySide.QtGui.QImage` color – `PySide.QtCore.Qt.GlobalColor` pixmap – `PySide.QtGui.QPixmap`

Constructs a default black brush with the style Qt.NoBrush (i.e. this brush will not fill shapes).

Constructs a copy of other .

Constructs a brush with the given color and the custom pattern stored in pixmap .

The style is set to Qt.TexturePattern . The color will only have an effect for QBitmaps.

See also

PySide.QtGui.QBrush.setColor() setPixmap()

Constructs a brush based on the given gradient .

The brush style is set to the corresponding gradient style (either Qt.LinearGradientPattern , Qt.RadialGradientPattern or Qt.ConicalGradientPattern ).

Constructs a brush with a black color and a texture set to the given image . The style is set to Qt.TexturePattern .

See also

PySide.QtGui.QBrush.setTextureImage()

Constructs a brush with a black color and a texture set to the given pixmap . The style is set to Qt.TexturePattern .

See also

PySide.QtGui.QBrush.setTexture()

PySide.QtGui.QBrush.color()¶

Return type:	`PySide.QtGui.QColor`

Returns the brush color.

See also

PySide.QtGui.QBrush.setColor()

PySide.QtGui.QBrush.gradient()¶

Return type:	`PySide.QtGui.QGradient`

Returns the gradient describing this brush.

PySide.QtGui.QBrush.init(color, bs)¶

Parameters:	color – `PySide.QtGui.QColor` bs – `PySide.QtCore.Qt.BrushStyle`

PySide.QtGui.QBrush.isOpaque()¶

Return type:	`PySide.QtCore.bool`

Returns true if the brush is fully opaque otherwise false. A brush is considered opaque if:

The alpha component of the PySide.QtGui.QBrush.color() is 255.
Its PySide.QtGui.QBrush.texture() does not have an alpha channel and is not a PySide.QtGui.QBitmap .
The colors in the PySide.QtGui.QBrush.gradient() all have an alpha component that is 255.
It is an extended radial gradient.

PySide.QtGui.QBrush.matrix()¶

Return type:	`PySide.QtGui.QMatrix`

Returns the current transformation matrix for the brush.

See also

PySide.QtGui.QBrush.setMatrix()

PySide.QtGui.QBrush.__ne__(b)¶

Parameters:	b – `PySide.QtGui.QBrush`
Return type:	`PySide.QtCore.bool`

Returns true if the brush is different from the given brush ; otherwise returns false.

Two brushes are different if they have different styles, colors or transforms or different pixmaps or gradients depending on the style.

See also

PySide.QtGui.QBrush.operator==()

PySide.QtGui.QBrush.__eq__(b)¶

Parameters:	b – `PySide.QtGui.QBrush`
Return type:	`PySide.QtCore.bool`

Returns true if the brush is equal to the given brush ; otherwise returns false.

Two brushes are equal if they have equal styles, colors and transforms and equal pixmaps or gradients depending on the style.

See also

PySide.QtGui.QBrush.operator!=()

PySide.QtGui.QBrush.setColor(color)¶

Parameters:	color – `PySide.QtGui.QColor`

Sets the brush color to the given color .

Note that calling PySide.QtGui.QBrush.setColor() will not make a difference if the style is a gradient. The same is the case if the style is Qt.TexturePattern style unless the current texture is a PySide.QtGui.QBitmap .

See also

PySide.QtGui.QBrush.color()

PySide.QtGui.QBrush.setColor(color)

Parameters:	color – `PySide.QtCore.Qt.GlobalColor`

PySide.QtGui.QBrush.setMatrix(mat)¶

Parameters:	mat – `PySide.QtGui.QMatrix`

Sets matrix as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with PySide.QtGui.QPainter transformation matrix to produce the final result.

See also

PySide.QtGui.QBrush.matrix()

PySide.QtGui.QBrush.setStyle(arg__1)¶

Parameters:	arg__1 – `PySide.QtCore.Qt.BrushStyle`

PySide.QtGui.QBrush.setTexture(pixmap)¶

Parameters:	pixmap – `PySide.QtGui.QPixmap`

Sets the brush pixmap to pixmap . The style is set to Qt.TexturePattern .

The current brush color will only have an effect for monochrome pixmaps, i.e. for QPixmap.depth() == 1 ( QBitmaps ).

See also

PySide.QtGui.QBrush.texture()

PySide.QtGui.QBrush.setTextureImage(image)¶

Parameters:	image – `PySide.QtGui.QImage`

Sets the brush image to image . The style is set to Qt.TexturePattern .

Note the current brush color will not have any affect on monochrome images, as opposed to calling PySide.QtGui.QBrush.setTexture() with a PySide.QtGui.QBitmap . If you want to change the color of monochrome image brushes, either convert the image to PySide.QtGui.QBitmap with QBitmap::fromImage() and set the resulting PySide.QtGui.QBitmap as a texture, or change the entries in the color table for the image.

PySide.QtGui.QBrush.setTransform(arg__1)¶

Parameters:	arg__1 – `PySide.QtGui.QTransform`

Sets matrix as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with PySide.QtGui.QPainter transformation matrix to produce the final result.

See also

PySide.QtGui.QBrush.transform()

PySide.QtGui.QBrush.style()¶

Return type:	`PySide.QtCore.Qt.BrushStyle`

Returns the brush style.

See also

PySide.QtGui.QBrush.setStyle()

PySide.QtGui.QBrush.swap(other)¶

Parameters:	other – `PySide.QtGui.QBrush`

Swaps brush other with this brush. This operation is very fast and never fails.

PySide.QtGui.QBrush.texture()¶

Return type:	`PySide.QtGui.QPixmap`

Returns the custom brush pattern, or a null pixmap if no custom brush pattern has been set.

See also

PySide.QtGui.QBrush.setTexture()

PySide.QtGui.QBrush.textureImage()¶

Return type:	`PySide.QtGui.QImage`

Returns the custom brush pattern, or a null image if no custom brush pattern has been set.

If the texture was set as a PySide.QtGui.QPixmap it will be converted to a PySide.QtGui.QImage .

See also

PySide.QtGui.QBrush.setTextureImage()

PySide.QtGui.QBrush.transform()¶

Return type:	`PySide.QtGui.QTransform`

Returns the current transformation matrix for the brush.

See also

PySide.QtGui.QBrush.setTransform()

Table Of Contents

Previous topic

Next topic

QBrush¶

Synopsis¶

Functions¶

Detailed Description¶

Table Of Contents

Previous topic

Next topic

Quick search

QBrush¶

Synopsis¶

Functions¶

Detailed Description¶