added new XSegEditor !

here new whole_face + XSeg workflow:

with XSeg model you can train your own mask segmentator for dst(and/or src) faces
that will be used by the merger for whole_face.

Instead of using a pretrained segmentator model (which does not exist),
you control which part of faces should be masked.

new scripts:
	5.XSeg) data_dst edit masks.bat
	5.XSeg) data_src edit masks.bat
	5.XSeg) train.bat

Usage:
	unpack dst faceset if packed

	run 5.XSeg) data_dst edit masks.bat

	Read tooltips on the buttons (en/ru/zn languages are supported)

	mask the face using include or exclude polygon mode.

	repeat for 50/100 faces,
		!!! you don't need to mask every frame of dst
		only frames where the face is different significantly,
		for example:
			closed eyes
			changed head direction
			changed light
		the more various faces you mask, the more quality you will get

		Start masking from the upper left area and follow the clockwise direction.
		Keep the same logic of masking for all frames, for example:
			the same approximated jaw line of the side faces, where the jaw is not visible
			the same hair line
		Mask the obstructions using exclude polygon mode.

	run XSeg) train.bat
		train the model

		Check the faces of 'XSeg dst faces' preview.

		if some faces have wrong or glitchy mask, then repeat steps:
			run edit
			find these glitchy faces and mask them
			train further or restart training from scratch

Restart training of XSeg model is only possible by deleting all 'model\XSeg_*' files.

If you want to get the mask of the predicted face (XSeg-prd mode) in merger,
you should repeat the same steps for src faceset.

New mask modes available in merger for whole_face:

XSeg-prd	  - XSeg mask of predicted face	-> faces from src faceset should be labeled
XSeg-dst	  - XSeg mask of dst face        	-> faces from dst faceset should be labeled
XSeg-prd*XSeg-dst - the smallest area of both

if workspace\model folder contains trained XSeg model, then merger will use it,
otherwise you will get transparent mask by using XSeg-* modes.

Some screenshots:
XSegEditor: https://i.imgur.com/7Bk4RRV.jpg
trainer   : https://i.imgur.com/NM1Kn3s.jpg
merger    : https://i.imgur.com/glUzFQ8.jpg

example of the fake using 13 segmented dst faces
          : https://i.imgur.com/wmvyizU.gifv

core/qtex/QSubprocessor.py

@@ -0,0 +1,262 @@
+import multiprocessing
+import sys
+import time
+import traceback
+
+from PyQt5.QtCore import *
+from PyQt5.QtGui import *
+from PyQt5.QtWidgets import *
+
+from core.interact import interact as io
+
+from .qtex import *
+
+class QSubprocessor(object):
+    """
+    
+    """
+
+    class Cli(object):
+        def __init__ ( self, client_dict ):
+            s2c = multiprocessing.Queue()
+            c2s = multiprocessing.Queue()
+            self.p = multiprocessing.Process(target=self._subprocess_run, args=(client_dict,s2c,c2s) )
+            self.s2c = s2c
+            self.c2s = c2s
+            self.p.daemon = True
+            self.p.start()
+
+            self.state = None
+            self.sent_time = None
+            self.sent_data = None
+            self.name = None
+            self.host_dict = None
+
+        def kill(self):
+            self.p.terminate()
+            self.p.join()
+
+        #overridable optional
+        def on_initialize(self, client_dict):
+            #initialize your subprocess here using client_dict
+            pass
+
+        #overridable optional
+        def on_finalize(self):
+            #finalize your subprocess here
+            pass
+
+        #overridable
+        def process_data(self, data):
+            #process 'data' given from host and return result
+            raise NotImplementedError
+
+        #overridable optional
+        def get_data_name (self, data):
+            #return string identificator of your 'data'
+            return "undefined"
+
+        def log_info(self, msg): self.c2s.put ( {'op': 'log_info', 'msg':msg } )
+        def log_err(self, msg):  self.c2s.put ( {'op': 'log_err' , 'msg':msg } )
+        def progress_bar_inc(self, c): self.c2s.put ( {'op': 'progress_bar_inc' , 'c':c } )
+
+        def _subprocess_run(self, client_dict, s2c, c2s):
+            self.c2s = c2s
+            data = None
+            try:
+                self.on_initialize(client_dict)
+                c2s.put ( {'op': 'init_ok'} )
+                while True:
+                    msg = s2c.get()
+                    op = msg.get('op','')
+                    if op == 'data':
+                        data = msg['data']
+                        result = self.process_data (data)
+                        c2s.put ( {'op': 'success', 'data' : data, 'result' : result} )
+                        data = None
+                    elif op == 'close':
+                        break
+                    time.sleep(0.001)
+                self.on_finalize()
+                c2s.put ( {'op': 'finalized'} )
+            except Exception as e:
+                c2s.put ( {'op': 'error', 'data' : data} )
+                if data is not None:
+                    print ('Exception while process data [%s]: %s' % (self.get_data_name(data), traceback.format_exc()) )
+                else:
+                    print ('Exception: %s' % (traceback.format_exc()) )
+            c2s.close()
+            s2c.close()
+            self.c2s = None
+
+        # disable pickling
+        def __getstate__(self):
+            return dict()
+        def __setstate__(self, d):
+            self.__dict__.update(d)
+
+    #overridable
+    def __init__(self, name, SubprocessorCli_class, no_response_time_sec = 0, io_loop_sleep_time=0.005):
+        if not issubclass(SubprocessorCli_class, QSubprocessor.Cli):
+            raise ValueError("SubprocessorCli_class must be subclass of QSubprocessor.Cli")
+
+        self.name = name
+        self.SubprocessorCli_class = SubprocessorCli_class
+        self.no_response_time_sec = no_response_time_sec
+        self.io_loop_sleep_time = io_loop_sleep_time
+
+        self.clis = []
+
+        #getting info about name of subprocesses, host and client dicts, and spawning them
+        for name, host_dict, client_dict in self.process_info_generator():
+            try:
+                cli = self.SubprocessorCli_class(client_dict)
+                cli.state = 1
+                cli.sent_time = 0
+                cli.sent_data = None
+                cli.name = name
+                cli.host_dict = host_dict
+
+                self.clis.append (cli)
+            except:
+                raise Exception (f"Unable to start subprocess {name}. Error: {traceback.format_exc()}")
+
+        if len(self.clis) == 0:
+            raise Exception ("Unable to start QSubprocessor '%s' " % (self.name))
+
+        #waiting subprocesses their success(or not) initialization
+        while True:
+            for cli in self.clis[:]:
+                while not cli.c2s.empty():
+                    obj = cli.c2s.get()
+                    op = obj.get('op','')
+                    if op == 'init_ok':
+                        cli.state = 0
+                    elif op == 'log_info':
+                        io.log_info(obj['msg'])
+                    elif op == 'log_err':
+                        io.log_err(obj['msg'])
+                    elif op == 'error':
+                        cli.kill()
+                        self.clis.remove(cli)
+                        break
+            if all ([cli.state == 0 for cli in self.clis]):
+                break
+            io.process_messages(0.005)
+
+        if len(self.clis) == 0:
+            raise Exception ( "Unable to start subprocesses." )
+
+        #ok some processes survived, initialize host logic
+        self.on_clients_initialized()
+                
+        self.q_timer = QTimer()
+        self.q_timer.timeout.connect(self.tick)
+        self.q_timer.start(5)
+        
+    #overridable
+    def process_info_generator(self):
+        #yield per process (name, host_dict, client_dict)
+        for i in range(min(multiprocessing.cpu_count(), 8) ):
+            yield 'CPU%d' % (i), {}, {}
+
+    #overridable optional
+    def on_clients_initialized(self):
+        #logic when all subprocesses initialized and ready
+        pass
+
+    #overridable optional
+    def on_clients_finalized(self):
+        #logic when all subprocess finalized
+        pass
+
+    #overridable
+    def get_data(self, host_dict):
+        #return data for processing here
+        raise NotImplementedError
+
+    #overridable
+    def on_data_return (self, host_dict, data):
+        #you have to place returned 'data' back to your queue
+        raise NotImplementedError
+
+    #overridable
+    def on_result (self, host_dict, data, result):
+        #your logic what to do with 'result' of 'data'
+        raise NotImplementedError
+
+    def tick(self):
+        for cli in self.clis[:]:
+            while not cli.c2s.empty():
+                obj = cli.c2s.get()
+                op = obj.get('op','')
+                if op == 'success':
+                    #success processed data, return data and result to on_result
+                    self.on_result (cli.host_dict, obj['data'], obj['result'])
+                    self.sent_data = None
+                    cli.state = 0
+                elif op == 'error':
+                    #some error occured while process data, returning chunk to on_data_return
+                    if 'data' in obj.keys():
+                        self.on_data_return (cli.host_dict, obj['data'] )
+                    #and killing process
+                    cli.kill()
+                    self.clis.remove(cli)
+                elif op == 'log_info':
+                    io.log_info(obj['msg'])
+                elif op == 'log_err':
+                    io.log_err(obj['msg'])
+                elif op == 'progress_bar_inc':
+                    io.progress_bar_inc(obj['c'])
+
+        for cli in self.clis[:]:
+            if cli.state == 1:
+                if cli.sent_time != 0 and self.no_response_time_sec != 0 and (time.time() - cli.sent_time) > self.no_response_time_sec:
+                    #subprocess busy too long
+                    io.log_info ( '%s doesnt response, terminating it.' % (cli.name) )
+                    self.on_data_return (cli.host_dict, cli.sent_data )
+                    cli.kill()
+                    self.clis.remove(cli)
+
+        for cli in self.clis[:]:
+            if cli.state == 0:
+                #free state of subprocess, get some data from get_data
+                data = self.get_data(cli.host_dict)
+                if data is not None:
+                    #and send it to subprocess
+                    cli.s2c.put ( {'op': 'data', 'data' : data} )
+                    cli.sent_time = time.time()
+                    cli.sent_data = data
+                    cli.state = 1
+
+        if all ([cli.state == 0 for cli in self.clis]):
+            #gracefully terminating subprocesses
+            for cli in self.clis[:]:
+                cli.s2c.put ( {'op': 'close'} )
+                cli.sent_time = time.time()
+
+            while True:
+                for cli in self.clis[:]:
+                    terminate_it = False
+                    while not cli.c2s.empty():
+                        obj = cli.c2s.get()
+                        obj_op = obj['op']
+                        if obj_op == 'finalized':
+                            terminate_it = True
+                            break
+
+                    if (time.time() - cli.sent_time) > 30:
+                        terminate_it = True
+
+                    if terminate_it:
+                        cli.state = 2
+                        cli.kill()
+
+                if all ([cli.state == 2 for cli in self.clis]):
+                    break
+
+            #finalizing host logic
+            self.q_timer.stop()
+            self.q_timer = None
+            self.on_clients_finalized()
+            

core/qtex/QXIconButton.py

@@ -0,0 +1,83 @@
+from PyQt5.QtCore import *
+from PyQt5.QtGui import *
+from PyQt5.QtWidgets import *
+
+from localization import StringsDB
+from .QXMainWindow import *
+
+class QXIconButton(QPushButton):
+    """
+    Custom Icon button that works through keyEvent system, without shortcut of QAction
+    works only with QXMainWindow as global window class
+    currently works only with one-key shortcut
+    """
+
+    def __init__(self, icon, 
+                    tooltip=None, 
+                    shortcut=None,                    
+                    click_func=None,                  
+                    first_repeat_delay=300,
+                    repeat_delay=20,
+                    ):
+
+        super().__init__(icon, "")
+
+        self.setIcon(icon)
+        
+        if shortcut is not None:
+            tooltip = f"{tooltip} ( {StringsDB['S_HOT_KEY'] }: {shortcut} )"
+        
+        self.setToolTip(tooltip)
+            
+        
+        self.seq = QKeySequence(shortcut) if shortcut is not None else None
+        
+        QXMainWindow.inst.add_keyPressEvent_listener ( self.on_keyPressEvent )
+        QXMainWindow.inst.add_keyReleaseEvent_listener ( self.on_keyReleaseEvent )
+        
+        self.click_func = click_func
+        self.first_repeat_delay = first_repeat_delay
+        self.repeat_delay = repeat_delay
+        self.repeat_timer = None
+        
+        self.op_device = None
+        
+        self.pressed.connect( lambda : self.action(is_pressed=True)  )
+        self.released.connect( lambda : self.action(is_pressed=False)  )
+        
+    def action(self, is_pressed=None, op_device=None):
+        if self.click_func is None:
+            return
+
+        if is_pressed is not None:
+            if is_pressed:
+                if self.repeat_timer is None:
+                    self.click_func()
+                    self.repeat_timer = QTimer()
+                    self.repeat_timer.timeout.connect(self.action)
+                    self.repeat_timer.start(self.first_repeat_delay)
+            else:
+                if self.repeat_timer is not None:
+                    self.repeat_timer.stop()
+                    self.repeat_timer = None
+        else:
+            self.click_func()
+            if self.repeat_timer is not None:
+                self.repeat_timer.setInterval(self.repeat_delay)
+        
+    def on_keyPressEvent(self, ev):              
+        key = ev.key()
+        if ev.isAutoRepeat():
+            return
+            
+        if self.seq is not None:
+            if key == self.seq[0]:
+                self.action(is_pressed=True)
+
+    def on_keyReleaseEvent(self, ev):
+        key = ev.key()
+        if ev.isAutoRepeat():
+            return
+        if self.seq is not None:
+            if key == self.seq[0]:
+                self.action(is_pressed=False)

core/qtex/QXMainWindow.py

@@ -0,0 +1,34 @@
+from PyQt5.QtCore import *
+from PyQt5.QtGui import *
+from PyQt5.QtWidgets import *
+
+class QXMainWindow(QWidget):
+    """
+    Custom mainwindow class that provides global single instance and event listeners
+    """
+    inst = None
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)        
+        if QXMainWindow.inst is not None:
+            raise Exception("QXMainWindow can only be one.")        
+        QXMainWindow.inst = self
+        
+        self.keyPressEvent_listeners = []
+        self.keyReleaseEvent_listeners = []
+        self.setFocusPolicy(Qt.WheelFocus)
+        
+    def add_keyPressEvent_listener(self, func):
+        self.keyPressEvent_listeners.append (func)
+        
+    def add_keyReleaseEvent_listener(self, func):
+        self.keyReleaseEvent_listeners.append (func)
+        
+    def keyPressEvent(self, ev):
+        super().keyPressEvent(ev)        
+        for func in self.keyPressEvent_listeners:
+            func(ev)
+            
+    def keyReleaseEvent(self, ev):
+        super().keyReleaseEvent(ev)        
+        for func in self.keyReleaseEvent_listeners:
+            func(ev)

core/qtex/__init__.py

@@ -0,0 +1,3 @@
+from .qtex import *
+from .QSubprocessor import *
+from .QXIconButton import *

core/qtex/qtex.py

@@ -0,0 +1,79 @@
+import numpy as np
+from PyQt5.QtCore import *
+from PyQt5.QtGui import *
+from PyQt5.QtWidgets import *
+from localization import StringsDB
+
+from .QXMainWindow import *
+            
+                
+class QActionEx(QAction):
+    def __init__(self, icon, text, shortcut=None, trigger_func=None, shortcut_in_tooltip=False, is_checkable=False, is_auto_repeat=False ):
+        super().__init__(icon, text)
+        if shortcut is not None:
+            self.setShortcut(shortcut)
+            if shortcut_in_tooltip:
+                
+                self.setToolTip( f"{text} ( {StringsDB['S_HOT_KEY'] }: {shortcut} )")
+                
+        if trigger_func is not None:
+            self.triggered.connect(trigger_func)
+        if is_checkable:            
+            self.setCheckable(True)
+        self.setAutoRepeat(is_auto_repeat)
+            
+def QImage_from_np(img):
+    if img.dtype != np.uint8:
+        raise ValueError("img should be in np.uint8 format")
+        
+    h,w,c = img.shape
+    if c == 1:
+        fmt = QImage.Format_Grayscale8
+    elif c == 3:
+        fmt = QImage.Format_BGR888
+    elif c == 4:
+        fmt = QImage.Format_ARGB32
+    else:
+      raise ValueError("unsupported channel count")  
+    
+    return QImage(img.data, w, h, c*w, fmt )
+        
+def QImage_to_np(q_img):
+    q_img = q_img.convertToFormat(QImage.Format_BGR888)
+
+    width = q_img.width()
+    height = q_img.height()
+    
+    b = q_img.constBits()
+    b.setsize(height * width * 3)
+    arr = np.frombuffer(b, np.uint8).reshape((height, width, 3))
+    return arr#[::-1]
+        
+def QPixmap_from_np(img):    
+    return QPixmap.fromImage(QImage_from_np(img))
+    
+def QPoint_from_np(n):
+    return QPoint(*n.astype(np.int))
+    
+def QPoint_to_np(q):
+    return np.int32( [q.x(), q.y()] )
+    
+def QSize_to_np(q):
+    return np.int32( [q.width(), q.height()] )
+    
+class QDarkPalette(QPalette):
+    def __init__(self):
+        super().__init__()
+        self.setColor(QPalette.Window, QColor(53, 53, 53))
+        self.setColor(QPalette.WindowText, Qt.white)
+        self.setColor(QPalette.Base, QColor(25, 25, 25))
+        self.setColor(QPalette.AlternateBase, QColor(53, 53, 53))
+        self.setColor(QPalette.ToolTipBase, Qt.white)
+        self.setColor(QPalette.ToolTipText, Qt.white)
+        self.setColor(QPalette.Text, Qt.white)
+        self.setColor(QPalette.Button, QColor(53, 53, 53))
+        self.setColor(QPalette.ButtonText, Qt.white)
+        self.setColor(QPalette.BrightText, Qt.red)
+        self.setColor(QPalette.Link, QColor(42, 130, 218))
+        self.setColor(QPalette.Highlight, QColor(42, 130, 218))
+        self.setColor(QPalette.HighlightedText, Qt.black)