def paintEvent(self, event):

    canvas = Qg.QPainter(self)                          #MainWindowのQPainterを取得

    pen = Qg.QPen(Qt.red)                               #赤色のペンを作り
    pen.setWidth(3)                                     #幅を3に設定して
    canvas.setPen(pen)                                  #それをPainterに設定
    canvas.setBrush(Qt.green)                           #緑のブラシを設定（単に色だけならこれでOK）
    canvas.drawRect(20, 20, 100, 100)                   #（20,20）の位置にサイズ100の正方形を描く

    canvas.setPen(Qt.blue)                              #ペンの色を青に設定（色だけなら同様にこれでOK）
    font = Qg.QFont()                                   #QFontを作成
    font.setPointSize(20)                               #文字のサイズを指定
    canvas.setFont(font)                                #フォントをPainterに設定
    canvas.drawText(150,50, "今日は朝から夜だった！")   #（150，50）の位置に文字を描画

• このやり方はDelphiとかでもほぼ同じで、そのためcanvasという変数名を使ってます。
• ただdrawRectのパラメータは左上の座標と長方形の幅と高さになるので注意して下さい。

1. ウインドウや画像のQPainterを取得する
2. QPen（線）やQBursh（塗りつぶしパターン）それにQFontなどをQPainterに設定して
3. 描画関数を呼び出す

drawRect, fillRect, drawLine, drawPolyline, drawPoint, drawEllipse, drawArc, drawPolygon, drawText, drawImage, drawPixmap ...

• Qtではともかく何でもかんでもがクラスになっているので最初は戸惑うかもしれませんが、慣れればこちらが便利でしょう。
• QPainterのドキュメントを見ると、描画開始と終了時にはbegin()とend()で囲め、みたいなことが書いてますが、そこはPyQtのズボラな優れたところで、気にしなくて構わなくなっているようです。

1. まずQPixmapまたはQImageを作成します。その際にQPixmapでは画像のサイズ、QImageではそれに加えてカラーフォーマットを指定します（よく分からなければQImage.Format_ARGB32でOK）
2. できた画像オブジェクトをパラメータにしてQPainterを作成します。
3. そのQPainterを使うことで作った画像に描画できます。
4. そうしておいてpaintEvent関数にはその画像をウインドウに描画するコードを書いておきます。

def onButtonClick(self):                                        #ボタンを押したときのスロット
    self.img = Qg.QImage(500, 500, Qg.QImage.Format_ARGB32)     #500*500ピクセルの画像を作成
    imgcanvas = Qg.QPainter(self.img)                           #画像のQPainterを取得

    #imgcanvasに対していろいろな描画処理

    self.update()                                               #画面をアップデートする

def paintEvent(self, event):
    canvas = Qg.QPainter(self)                                  #メインウインドウのPainterに
    canvas.drawImage(0, 0, self.img)                            #上記のイメージを描画する

1. コンストラクタでグラデーション開始位置と終了位置を指定します。
2. 続いてsetColorAt(float, QColor)という関数で色を指定しますが、その際のfloatのパラメータが何かというと、開始位置と終了位置を線で結んで、開始位置を0.0、終了位置を1.0としたときのその中間点を表す場所です。

    grad.setColorAt(0.1, Qg.QColor(Qt.red))
    grad.setColorAt(1.0, Qg.QColor(Qt.blue))

    grad.setColorAt(0.1, Qg.QColor(Qt.red))
    grad.setColorAt(0.5, Qg.QColor(Qt.green))
    grad.setColorAt(1.0, Qg.QColor(Qt.blue))

• なお、グラデーション定義の座標は描画している図形ではなく、使用しているQPainterの座標です。そのため異なった位置にある図形にグラデーションを設定したい場合は、それぞれにQGradientを作成する必要があります。

def paintEvent(self, event):

    canvas = Qg.QPainter(self)                  #画面のPainterを取得する

    #線形グラデーション
    grad = Qg.QLinearGradient(25,0,75,100)      #座標（25,0）～（75,100）間で定義
    grad.setColorAt(0.1, Qg.QColor(Qt.red))     #色の位置の設定
    grad.setColorAt(0.5, Qg.QColor(Qt.green))
    grad.setColorAt(1.0, Qg.QColor(Qt.blue))
    canvas.setBrush(Qg.QBrush(grad))            #画面に描画する
    canvas.drawRect(0,0,100,100)

    #放射状グラデーション
    grad = Qg.QRadialGradient(150,50,50,160,60) #（150,50）を中心、半径50、（160,60）が開始位置
    grad.setColorAt(0.0, Qg.QColor(Qt.white))   #色を指定
    grad.setColorAt(1.0, Qg.QColor(Qt.blue))
    canvas.setBrush(Qg.QBrush(grad))            #画面への描画
    canvas.drawRect(100,0,100,100)

    #円錐形グラデーション
    grad = Qg.QConicalGradient(250, 50, 45)     #座標（250,50）を中心に45度角から開始
    grad.setColorAt(0.0, Qg.QColor(Qt.red))     #色の指定
    grad.setColorAt(0.33, Qg.QColor(Qt.green))
    grad.setColorAt(0.66, Qg.QColor(Qt.blue))
    grad.setColorAt(1.0, Qg.QColor(Qt.red))
    canvas.setBrush(Qg.QBrush(grad))            #画面への描画
    canvas.drawRect(200,0,100,100)

void QPixmap::setAlphaChannel(const QPixmap &p)

---

This function is deprecated.

Most use cases for this can be achieved using p with QPainter and QPainter::CompositionMode instead.

def paintEvent(self, event):

    canvas = Qg.QPainter(self)                      #画面のPainterを取得する

    self.img1 = Qg.QImage('sample1.png')            #渦巻き画像
    self.img2 = Qg.QImage('sample2.jpg')            #仏像写真
    canvas.drawImage(0, 0, self.img1)               #プレビューのため表示
    canvas.drawImage(200, 0, self.img2)

    self.img3 = Qg.QImage(
            200, 200, Qg.QImage.Format_ARGB32)      #渦巻き画像にアルファチャンネルがないので
    img3canvas = Qg.QPainter(self.img3)             #アルファのある下地を作り（補足）
    img3canvas.drawImage(0, 0, self.img1)           #そこに渦巻きを上書きして作業する

    img3canvas.setBrush(Qg.QColor('#50000000'))     #Painterに半透明色を設定
    img3canvas.setCompositionMode(
            canvas.CompositionMode_DestinationIn)   #CompositionModeを設定
    img3canvas.drawEllipse(40, 40, 120, 120)        #画像中央に円を描く

    canvas.drawImage(400, 0, self.img2)             #仏像を描画
    canvas.drawImage(400, 0, self.img3)             #そのうえから処理した渦巻きを描画

• ちなみにこのコンポジションモードが完全サポートされるのはどうもQImageから得られたQPainterのみらしいので、こういった画像操作をしたい場合はQImageを使う必要があるようです。

• QImageにはカラーフォーマットをコンバートする関数もあるみたいなのですが、やってみてもうまくいかなかったりして、どうもよく分かりませんでした。

    onPaint = Qc.pyqtSignal(Qg.QPaintEvent, Qg.QPainter)

• PyQtというのはそのほとんどがQtの関数のラッピングでできていますが、シグナル＋スロット機構というのは単なるラッピングではできないようで、名前のとおりこれはPyQt独自のものです（そのためPySideでは書き方が違うようです）

• この場合元のイベントはQPaintEventだけですが、丸投げ先でPaintBoxのPainterを簡単に使えるようにこれも一緒に飛ばしています。

    def paintEvent(self, event: Qg.QPaintEvent):
        canvas = Qg.QPainter(self)
        self.onPaint.emit(event, canvas)                #シグナルの発行

# -*- coding: utf-8 -*-
from PyQt5 import QtCore as Qc, QtGui as Qg, QtWidgets as Qw

#QObjectを継承しなければいけない（QWidgetは大丈夫）
class TPaintWidget(Qw.QWidget):

    #シグナル定義。パラメータの「型」を引数にする
    onPaint = Qc.pyqtSignal(Qg.QPaintEvent, Qg.QPainter)
    onMousePress = Qc.pyqtSignal(Qg.QMouseEvent)
    onMouseMove = Qc.pyqtSignal(Qg.QMouseEvent)
    onMouseRelease = Qc.pyqtSignal(Qg.QMouseEvent)
    onDoubleClick = Qc.pyqtSignal(Qg.QMouseEvent)

    def paintEvent(self, event: Qg.QPaintEvent):
        canvas = Qg.QPainter(self)
        self.onPaint.emit(event, canvas)                #シグナルの発行

    def mousePressEvent(self, event: Qg.QMouseEvent):
        self.onMousePress.emit(event)

    def mouseMoveEvent(self, event: Qg.QMouseEvent):
        self.onMouseMove.emit(event)

    def mouseReleaseEvent(self, event: Qg.QMouseEvent):
        self.onMouseRelease.emit(event)

    def mouseDoubleClickEvent(self, event: Qg.QMouseEvent):
        self.onDoubleClick.emit(event)

• なお、シグナル定義ができるのはQObjectのサブクラスですが、QWidgetをはじめ、大抵のクラスがそうなのであまり気にすることはないでしょう。

• その際、例えば上記のonPaintは引数を二つ取りますが、そのあたりを特に気にする必要はなく単に()にしておいて問題ありません。

• なお、何か間違いなどがありましたらこちらの方にコメントしてください（質問等でも構いませんが、多分答える能力があまりないのではないかと思います）