IC Python API:Icons and Images

From Reallusion Wiki!
Revision as of 23:48, 18 February 2020 by Chuck (RL) (Talk | contribs) (Created page with "{{TOC}} {{Parent|IC_Python_API:RL_Python_Samples|RL Python Samples}} left During your iClone Python journey, you'll eventuall...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Main article: RL Python Samples.
Ic python api doge petter 01.png

During your iClone Python journey, you'll eventually want to decorate your user interface with images and button icons. This article will go over just that with the creation of a Doge Petter application within iClone. We will create a portrait for Doge, a counter for the number of times Doge was petted, and finally a button for petting Doge decorated with a hand icon.

Required Modules and Global Variables

Besides the rudimentary Reallusion Python module, we'll also need Pyside2 to build the user interface. And we'll need a global variable to keep track of the number of times we Doge was petted.

import RLPy
import os
from PySide2 import QtWidgets
from PySide2.shiboken2 import wrapInstance
from PySide2.QtCore import Qt
from PySide2 import QtGui

pet_count = 0

You may have also notice two unusual modules: QtCore.Qt and QtGui. We'll need QtCore.Qt to align text within QT labels and QtGui to create the images and icones via QPixmap and QIcon respectively.

Creating the User Interface

Ic python api doge petter 02.png

Next, we'll need to create the user interface for the Doge Petter application.

window = RLPy.RUi.CreateRDialog()
window.SetWindowTitle("Doge Petter")

qt_dialog = wrapInstance(int(window.GetWindow()), QtWidgets.QDialog)
qt_dialog.setFixedWidth(370)
qt_dialog.setFixedHeight(280)

# Create the doge image
doge_portrait = QtWidgets.QLabel()
doge_portrait.setFixedWidth(350)
doge_portrait.setFixedHeight(190)
doge_portrait.setPixmap(QtGui.QPixmap(os.path.dirname(__file__) + "/doge.png"))

# Create a "petting" counter
pet_string = "You have petted Doge {} times"
pet_times_label = QtWidgets.QLabel(pet_string.format(pet_count))
pet_times_label.setAlignment(Qt.AlignCenter)

# Create a "petting" button
pet_button = QtWidgets.QPushButton(text="Pet Doge")
pet_button.setFixedHeight(25)
pet_button.setIcon(QtGui.QIcon(os.path.dirname(__file__) + "/hand.svg"))

# Add all of the UI elements to the window layout
for widget in [doge_portrait, pet_times_label, pet_button]:
    qt_dialog.layout().addWidget(widget)

window.Show()

Let's Pet Doge

Ic python api doge petter 03.png

For fun and sake of completion, let's connect a function to the Pet Doge button:

def pet_doge():
    global pet_count

    pet_count += 1
    pet_times_label.setText(pet_string.format(pet_count))


pet_button.clicked.connect(pet_doge)

Everything Put Together

import RLPy
import os
from PySide2 import QtWidgets
from PySide2.shiboken2 import wrapInstance
from PySide2.QtCore import Qt
from PySide2 import QtGui

pet_count = 0

window = RLPy.RUi.CreateRDialog()
window.SetWindowTitle("Doge Petter")

qt_dialog = wrapInstance(int(window.GetWindow()), QtWidgets.QDialog)
qt_dialog.setFixedWidth(370)
qt_dialog.setFixedHeight(280)

# Create the doge image
doge_portrait = QtWidgets.QLabel()
doge_portrait.setFixedWidth(350)
doge_portrait.setFixedHeight(190)
doge_portrait.setPixmap(QtGui.QPixmap(os.path.dirname(__file__) + "/doge.png"))

# Create a "petting" counter
pet_string = "You have petted Doge {} times"
pet_times_label = QtWidgets.QLabel(pet_string.format(pet_count))
pet_times_label.setAlignment(Qt.AlignCenter)

# Create a "petting" button
pet_button = QtWidgets.QPushButton(text="Pet Doge")
pet_button.setFixedHeight(25)
pet_button.setIcon(QtGui.QIcon(os.path.dirname(__file__) + "/hand.svg"))

# Add all of the UI elements to the window layout
for widget in [doge_portrait, pet_times_label, pet_button]:
    qt_dialog.layout().addWidget(widget)

window.Show()


def pet_doge():
    global pet_count

    pet_count += 1
    pet_times_label.setText(pet_string.format(pet_count))


pet_button.clicked.connect(pet_doge)