Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 8.34 KB

general_usage.md

File metadata and controls

95 lines (67 loc) · 8.34 KB
Raw

General Usage

  • Install vmulti from vmulti/vmulti_driver.zip. (Extract and run install_hiddriver.bat as admin.)

  • Change SERIAL_PORT_PATH in KuuubeTD/user_constants.py to the path the tablet is connected to.

    If you are unsure which path to use, run tools/find_serial_port_paths.py. (You may have to guess between a few if there are multiple options.)

  • For proper monitor mapping, change the following variables in KuuubeTD/user_constants.py to the correct values for your setup:

    ALL_MONITORS_RES_X: This is the X axis resolution of all your monitors combined.

    For example, two 1920 x 1080 monitors positioned side by side have an ALL_MONITORS_RES_X of 3840, and two 1920 x 1080 monitors positioned up and down have an ALL_MONITORS_RES_X of 1080.

    ALL_MONITORS_RES_Y: This is the Y axis resolution of all your monitors combined.

    For example, two 1920 x 1080 monitors positioned side by side have an ALL_MONITORS_RES_Y of 1080, and two 1920 x 1080 monitors positioned up and down have an ALL_MONITORS_RES_Y of 2160.

    MAPPED_MONITOR_RES_X: This is the X axis resolution of the monitor mapping to apply.

    For example, to map to a 1920 x 1080 monitor, the MAPPED_MONITOR_RES_X will be 1920 regardless of how many monitors you have.

    MAPPED_MONITOR_RES_Y: This is the Y axis resolution of the monitor mapping to apply.

    For example, to map to a 1920 x 1080 monitor, the MAPPED_MONITOR_RES_Y will be 1080 regardless of how many monitors you have.

    MONITOR_OFFSET_X: This is the X axis offset to apply to MAPPED_MONITOR_RES_X. (Offsets are added from the top left corner.)

    For example, on a setup with two 1920 x 1080 monitors side by side, to map to the right monitor, MONITOR_OFFSET_X will be 1920, and to map to the left monitor, MONITOR_OFFSET_X will be 0.

    MONITOR_OFFSET_Y: This is the Y axis offset to apply to MAPPED_MONITOR_RES_Y. (Offsets are added from the top left corner.)

    For example, on a setup with two 1920 x 1080 monitors up and down, to map to the bottom monitor, MONITOR_OFFSET_Y will be 1080, and to map to the top monitor, MONITOR_OFFSET_Y will be 0.

  • In KuuubeTD/user_constants.py set TABLET_MAX_X_POS and TABLET_MAX_Y_POS based on the size of your tablet.

    To find your tablet's ROM version, follow Finding ROM Version.

    Estimated sizes:

    Tablet Model ROM Estimated Max X Pos Estimated Max Y Pos Tested Max X Pos Tested Max Y Pos
    XD-0405-R Wacom V 2.0 12700 10600
    XD-0608-R Wacom V 2.0 20320 16240
    XD-0912-R Wacom V 2.0 30480 24060
    XD-1212-R Wacom V 2.0 30480 31680
    XD-1218-R Wacom V 2.0 45720 31680
    GD-0405-R Wacom V 2.0 12700 10600
    GD-0608-R Wacom V 2.0 20320 16240 20320 16240
    GD-0912-R Wacom V 2.0 30480 24060
    GD-1212-R Wacom V 2.0 30480 31680
    GD-1218-R Wacom V 2.0 45720 31680
    UD-0608-R Wacom IVe 1.4 20480 15360
    UD-1212-R Wacom IVe 1.4 30480 30480
    UD-1218-R Wacom IVe 1.4 45720 30480
    UD-1825-R Wacom IVe 1.4 63500 46200
    UD-0608-R Wacom IV 1.2-1.4 20480 15360
    UD-1212-R Wacom IV 1.2-1.4 30480 30480
    UD-1218-R Wacom IV 1.2-1.4 45720 30480
    UD-1825-R Wacom IV 1.2-1.4 63500 46200
    KT-0405-R Wacom IV 1.2-1.4 12800 9600 12800 9600
    KT-0405-R Wacom IV 1.0-1.1 6400 4800
    UD-0608-R Wacom IV 1.0-1.1 10240 7680
    UD-1212-R Wacom IV 1.0-1.1 15240 15240
    UD-1218-R Wacom IV 1.0-1.1 22860 15240
    UD-1825-R Wacom IV 1.0-1.1 31750 23100
    SD-510C Wacom II-S 6960 4530 4640 3020
    SD-420E Wacom II 15240 15240
    SD-421E Wacom II 15240 15240
    SD-422E Wacom II 15240 15240 15240 15240
    SD-320E Wacom II 18050 18050
    SD-321E Wacom II 18050 18050
    SD-322E Wacom II 18050 18050
    SD-310E Wacom II 22860 15240
    SD-311E Wacom II 22860 15240
    SD-312E Wacom II 22860 15240
    SD-210L Wacom II 31750 23100
    SD-013A Wacom II 59650 44450
    SD-013L Wacom II 59650 44450

  • Optionally, to use a custom tablet area instead of full area, change the following variables in KuuubeTD/user_constants.py to the desired values:

    TABLET_MAX_X_POS: The tablet area width in tablet coordinates to use for the size of the tablet area.

    TABLET_MAX_Y_POS: The tablet area height in tablet coordinates to use for the size of the tablet area.

    TABLET_OFFSET_X: The X axis offset to apply to TABLET_MAX_X_POS in tablet coordinates to change the position of the tablet area. (Offsets are added from the top left corner.)

    TABLET_OFFSET_Y: The Y axis offset to apply to TABLET_MAX_Y_POS in tablet coordinates to change the position of the tablet area. (Offsets are added from the top left corner.)

  • If your tablet is reporting pressure when hovering but maxes at the correct pressure it may require a pressure deadzone or if it's reporting pressure when hovering and sending pressure over the max it may require a pressure offset. To find the pressure values your tablet is reporting, run KuuubeTD/debugger.py. Then change the following variables in KuuubeTD/user_constants.py:

    PRESSURE_DEADZONE: All pressure values at or below this value will be ignored.

    PRESSURE_OFFSET: Adds this value to the pressure. (Use a negative offset if your tablet is reporting pressure too high)