QPaintedTextureImage#
A QAbstractTextureImage
that can be written through a QPainter. More…
Synopsis#
Properties#
Functions#
Virtual functions#
def
paint
(painter)
Slots#
Signals#
def
heightChanged
(w)def
sizeChanged
(size)def
widthChanged
(w)
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
Detailed Description#
A QPaintedTextureImage
provides a way to specify a texture image (and thus an OpenGL texture) through a QPainter. The width and height of the texture image can be specified through the width and height or size properties.
A QPaintedTextureImage
must be subclassed and the virtual paint()
function implemented. Each time update()
is called on the QPaintedTextureImage
, the paint()
function is invoked and the resulting image is uploaded.
The QPaintedTextureImage
must be attached to some QAbstractTexture
.
- class PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage([parent=None])#
- Parameters:
parent –
PySide6.Qt3DCore.Qt3DCore.QNode
Note
Properties can be used directly when from __feature__ import true_property
is used or via accessor functions otherwise.
- property PᅟySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.height: int#
This property holds the height of the texture image. The height must be greater than or equal to 1.
- Access functions:
height
()setHeight
(h)Signal
heightChanged
(w)
- property PᅟySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.size: PySide6.QtCore.QSize#
This property holds the size of the texture image.
- Access functions:
size
()setSize
(size)Signal
sizeChanged
(size)
- property PᅟySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.width: int#
This property holds the width of the texture image. The width must be greater than or equal to 1.
- Access functions:
width
()setWidth
(w)Signal
widthChanged
(w)
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.height()#
- Return type:
int
See also
Getter of property height
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.heightChanged(w)#
- Parameters:
w – int
Notification signal of property height
.
- abstract PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.paint(painter)#
- Parameters:
painter –
PySide6.QtGui.QPainter
Paints the texture image with the specified QPainter object painter
.
QPainter considers the top-left corner of an image as its origin, while OpenGL considers the bottom-left corner of a texture as its origin. An easy way to account for this difference is to set a custom viewport on the painter before doing any other painting:
painter->setViewport(0, height(), width(), -height()); ...
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.setHeight(h)#
- Parameters:
h – int
Sets the height (h
) of the texture image. Triggers an update, if the size changes.
See also
Setter of property height
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.setSize(size)#
- Parameters:
size –
PySide6.QtCore.QSize
Sets the width and height of the texture image. Triggers an update, if the size
changes.
See also
Setter of property size
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.setWidth(w)#
- Parameters:
w – int
Sets the width (w
) of the texture image. Triggers an update, if the size changes.
See also
Setter of property width
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.size()#
- Return type:
See also
Getter of property size
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.sizeChanged(size)#
- Parameters:
size –
PySide6.QtCore.QSize
Notification signal of property size
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.update([rect=QRect()])#
- Parameters:
rect –
PySide6.QtCore.QRect
Immediately triggers the painted texture’s paint()
function, which in turn uploads the new image to the GPU. If you are making multiple changes to a painted texture, consider waiting until all changes are complete before calling update, in order to minimize the number of repaints required.
Parameter rect
is currently unused.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.width()#
- Return type:
int
See also
Getter of property width
.
- PySide6.Qt3DRender.Qt3DRender.QPaintedTextureImage.widthChanged(w)#
- Parameters:
w – int
Notification signal of property width
.