dialogbox_EN
dokibox.dialogbox(msg="", w=None, h=220, name=None, typewriter=True, chardelay=50, bold=False)| Parameter | Type | Default | Description |
|---|---|---|---|
msg |
str | "" |
Message text |
w |
int | None |
Width (default: 60% of screen width) |
h |
int | 220 |
Height |
name |
str or dokibox.Avatar (see below) |
None |
Character name tag (white rounded label protruding above the dialog). Pass an Avatar to enable auto speaker detection with sprites. |
typewriter |
bool | True |
Typewriter mode |
chardelay |
int | 50 |
Typewriter interval per character (ms) |
bold |
bool | False |
Bold black stroke on text |
overflow_mode |
str | wrap |
How to handle text exceeding dialog width: wrap – wrap to next line; overflow – expand window so text renders past the boundary; hide – clip text at the boundary |
font_family |
str | None |
Font family (default: "Microsoft YaHei"). Set to None to use default. |
font_size |
int | None |
Font size in points (default: 20). Set to None to use default. |
fdst |
bool | False |
If True, destroys the window when dismissed. Use for the final line of a dialogue scene or story branch to ensure the window closes completely. |
transparent |
bool | True |
Apply alpha gradient from top to bottom, making the body see-through |
glare |
bool | True |
Draw a white semicircular highlight at the bottom of the dialog |
pinned |
bool | True |
Keep window on top |
savecall |
function | None | Behavior of the Save button at the bottom of dialogbox. See Bottom Button of dialogbox for details. |
loadcall |
function | None | Behavior of the Load button at the bottom of dialogbox. See Bottom Button of dialogbox for details. |
settingscall |
function | None | Behavior of the Settings button at the bottom of dialogbox. See Bottom Button of dialogbox for details. |
Sprite-related APIs are not listed in this table — see the Sprite section below.
In typewriter mode:
- Text appears character by character
- First click → reveals full text instantly
- Second click → closes
dokibox.dialogbox("Do you actually go by Administrator or something?", name="Monika")
dokibox.dialogbox("Slower...", chardelay=80, bold=True)
dokibox.dialogbox("All at once", typewriter=False)