Skip to content

Configuration

veethree edited this page Oct 18, 2021 · 3 revisions

One of my design goals for KDP is for it to be highly customizable. To that end, There is a config.ini file that gets created the first time you run KDP, Which you can edit to customize how KDP looks and behaves.

Here's how it looks as for version 0.1.1

[keys]
cursor_warp_color_left="wcleft"
cursor_line_right="wdright"
cursor_warp_left="wwleft"
redo="y"
cursor_warp_color_right="wcright"
undo="u"
cursor_warp_color_down="wcdown"
cursor_fill="f"
cursor_line_color_down="dcdown"
cursor_warp_right="wwright"
cursor_warp_up="wwup"
cursor_warp_down="wwdown"
horizontal_mirror="mh"
toggle_fullscreen="f2"
select_mode="s"
cursor_erase="x"
cursor_right="right"
move_palette_cursor="lctrl"
cursor_line_left="wdleft"
vertical_mirror="mv"
cursor_left="left"
cursor_draw="d"
cursor_down="down"
select_palette_color="cc"
clear_mirror="mm"
cursor_line_up="wdup"
copy_mode="g"
toggle_command_box="tab"
cursor_line_color_left="dcleft"
cursor_warp_color_up="wcup"
cursor_line_color_right="dcright"
cursor_up="up"
cursor_line_down="wddown"
cursor_pick="t"
toggle_grid="f1"
cursor_line_color_up="dcup"
cut_mode="lshiftg"
[color]
editor_cursor_color={20, 126, 255}
background_global={32, 32, 32}
text_default={255, 255, 255}
selection={255, 0, 255}
debug_background={0, 0, 0, 100}
background_alt={20, 20, 20}
debug_text={255, 0, 255}
text_alt={200, 200, 200}
prompt_shade={0, 0, 0, 255}
mirror={91, 156, 222}
[settings]
command_timeout=0.3
max_palette_columns=8
show_grid=false
file_drop_action="region"
window_width=800
window_fullscreen=false
editor_border_width=4
window_resizable=true
window_height=600
use_history=true
default_mode="drawMode"
debug=false
max_undo_steps=100
max_palette_rows=32
empty_pixel={0, 0, 0, 0}
[font]
file="src/font/monogram.ttf"
[palette]
default="src/palette/duel-1x.png"

Most of the setting should be pretty self explanatory. Some of the less obvious ones are:

command_timeout: KDP Keeps track of your keystrokes internally. Each key you press is stored in a buffer, Which you can see on the bottom right after "cmd: ". This value is used to determine the time after which the buffer is cleared when no keys are pressed.

max_palette_columns & max_palette_rows: These refer to the color palette on the right and how its rendered. The default values allow for a palette with 256 colors.

file_drop_action: This value decides how KDP reacts to a file being dropped on it. This needs to be one of the following strings:

  • region: This is the default. It means that if the file is dropped over the palette area, It will be loaded as a palette, Otherwise it's loaded as an image.
  • prompt: A prompt will show up asking the user what to do.
  • image: All dropped files will be loaded as images
  • palette: All dropped files will be loaded as palettes

use_history: If this is set to false, KDP Won't keep track of previous steps, And so undo and redo will not work.

show_grid: If true, An outline is rendered around pixels in your image.

empty_pixel: This determines what KDP Considers an empty pixel. Used for erasing and initializing new images.

Clone this wiki locally