forked from mypaint/libmypaint
-
Notifications
You must be signed in to change notification settings - Fork 0
/
brushsettings.json
534 lines (534 loc) · 23.2 KB
/
brushsettings.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
{
"inputs": [
{
"displayed_name": "Pressure",
"hard_maximum": null,
"hard_minimum": 0.0,
"id": "pressure",
"normal": 0.4,
"soft_maximum": 1.0,
"soft_minimum": 0.0,
"tooltip": "The pressure reported by the tablet. Usually between 0.0 and 1.0, but it may get larger when a pressure gain is used. If you use the mouse, it will be 0.5 when a button is pressed and 0.0 otherwise."
},
{
"displayed_name": "Fine speed",
"hard_maximum": null,
"hard_minimum": null,
"id": "speed1",
"normal": 0.5,
"soft_maximum": 4.0,
"soft_minimum": 0.0,
"tooltip": "How fast you currently move. This can change very quickly. Try 'print input values' from the 'help' menu to get a feeling for the range; negative values are rare but possible for very low speed."
},
{
"displayed_name": "Gross speed",
"hard_maximum": null,
"hard_minimum": null,
"id": "speed2",
"normal": 0.5,
"soft_maximum": 4.0,
"soft_minimum": 0.0,
"tooltip": "Same as fine speed, but changes slower. Also look at the 'gross speed filter' setting."
},
{
"displayed_name": "Random",
"hard_maximum": 1.0,
"hard_minimum": 0.0,
"id": "random",
"normal": 0.5,
"soft_maximum": 1.0,
"soft_minimum": 0.0,
"tooltip": "Fast random noise, changing at each evaluation. Evenly distributed between 0 and 1."
},
{
"displayed_name": "Stroke",
"hard_maximum": 1.0,
"hard_minimum": 0.0,
"id": "stroke",
"normal": 0.5,
"soft_maximum": 1.0,
"soft_minimum": 0.0,
"tooltip": "This input slowly goes from zero to one while you draw a stroke. It can also be configured to jump back to zero periodically while you move. Look at the 'stroke duration' and 'stroke hold time' settings."
},
{
"displayed_name": "Direction",
"hard_maximum": 180.0,
"hard_minimum": 0.0,
"id": "direction",
"normal": 0.0,
"soft_maximum": 180.0,
"soft_minimum": 0.0,
"tooltip": "The angle of the stroke, in degrees. The value will stay between 0.0 and 180.0, effectively ignoring turns of 180 degrees."
},
{
"displayed_name": "Declination",
"hard_maximum": 90.0,
"hard_minimum": 0.0,
"id": "tilt_declination",
"normal": 0.0,
"soft_maximum": 90.0,
"soft_minimum": 0.0,
"tooltip": "Declination of stylus tilt. 0 when stylus is parallel to tablet and 90.0 when it's perpendicular to tablet."
},
{
"displayed_name": "Ascension",
"hard_maximum": 180.0,
"hard_minimum": -180.0,
"id": "tilt_ascension",
"normal": 0.0,
"soft_maximum": 180.0,
"soft_minimum": -180.0,
"tooltip": "Right ascension of stylus tilt. 0 when stylus working end points to you, +90 when rotated 90 degrees clockwise, -90 when rotated 90 degrees counterclockwise."
},
{
"displayed_name": "Custom",
"hard_maximum": null,
"hard_minimum": null,
"id": "custom",
"normal": 0.0,
"soft_maximum": 2.0,
"soft_minimum": -2.0,
"tooltip": "This is a user defined input. Look at the 'custom input' setting for details."
}
],
"settings": [
{
"constant": false,
"default": 1.0,
"displayed_name": "Opacity",
"internal_name": "opaque",
"maximum": 2.0,
"minimum": 0.0,
"tooltip": "0 means brush is transparent, 1 fully visible\n(also known as alpha or opacity)"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Opacity multiply",
"internal_name": "opaque_multiply",
"maximum": 2.0,
"minimum": 0.0,
"tooltip": "This gets multiplied with opaque. You should only change the pressure input of this setting. Use 'opaque' instead to make opacity depend on speed.\nThis setting is responsible to stop painting when there is zero pressure. This is just a convention, the behaviour is identical to 'opaque'."
},
{
"constant": true,
"default": 0.9,
"displayed_name": "Opacity linearize",
"internal_name": "opaque_linearize",
"maximum": 2.0,
"minimum": 0.0,
"tooltip": "Correct the nonlinearity introduced by blending multiple dabs on top of each other. This correction should get you a linear (\"natural\") pressure response when pressure is mapped to opaque_multiply, as it is usually done. 0.9 is good for standard strokes, set it smaller if your brush scatters a lot, or higher if you use dabs_per_second.\n0.0 the opaque value above is for the individual dabs\n1.0 the opaque value above is for the final brush stroke, assuming each pixel gets (dabs_per_radius*2) brushdabs on average during a stroke"
},
{
"constant": false,
"default": 2.0,
"displayed_name": "Radius",
"internal_name": "radius_logarithmic",
"maximum": 6.0,
"minimum": -2.0,
"tooltip": "Basic brush radius (logarithmic)\n 0.7 means 2 pixels\n 3.0 means 20 pixels"
},
{
"constant": false,
"default": 0.8,
"displayed_name": "Hardness",
"internal_name": "hardness",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Hard brush-circle borders (setting to zero will draw nothing). To reach the maximum hardness, you need to disable Pixel feather."
},
{
"constant": false,
"default": 1.0,
"displayed_name": "Pixel feather",
"internal_name": "anti_aliasing",
"maximum": 5.0,
"minimum": 0.0,
"tooltip": "This setting decreases the hardness when necessary to prevent a pixel staircase effect (aliasing) by making the dab more blurred.\n 0.0 disable (for very strong erasers and pixel brushes)\n 1.0 blur one pixel (good value)\n 5.0 notable blur, thin strokes will disappear"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Dabs per basic radius",
"internal_name": "dabs_per_basic_radius",
"maximum": 6.0,
"minimum": 0.0,
"tooltip": "How many dabs to draw while the pointer moves a distance of one brush radius (more precise: the base value of the radius)"
},
{
"constant": true,
"default": 2.0,
"displayed_name": "Dabs per actual radius",
"internal_name": "dabs_per_actual_radius",
"maximum": 6.0,
"minimum": 0.0,
"tooltip": "Same as above, but the radius actually drawn is used, which can change dynamically"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Dabs per second",
"internal_name": "dabs_per_second",
"maximum": 80.0,
"minimum": 0.0,
"tooltip": "Dabs to draw each second, no matter how far the pointer moves"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Radius by random",
"internal_name": "radius_by_random",
"maximum": 1.5,
"minimum": 0.0,
"tooltip": "Alter the radius randomly each dab. You can also do this with the by_random input on the radius setting. If you do it here, there are two differences:\n1) the opaque value will be corrected such that a big-radius dabs is more transparent\n2) it will not change the actual radius seen by dabs_per_actual_radius"
},
{
"constant": false,
"default": 0.04,
"displayed_name": "Fine speed filter",
"internal_name": "speed1_slowness",
"maximum": 0.2,
"minimum": 0.0,
"tooltip": "How slow the input fine speed is following the real speed\n0.0 change immediately as your speed changes (not recommended, but try it)"
},
{
"constant": false,
"default": 0.8,
"displayed_name": "Gross speed filter",
"internal_name": "speed2_slowness",
"maximum": 3.0,
"minimum": 0.0,
"tooltip": "Same as 'fine speed filter', but note that the range is different"
},
{
"constant": true,
"default": 4.0,
"displayed_name": "Fine speed gamma",
"internal_name": "speed1_gamma",
"maximum": 8.0,
"minimum": -8.0,
"tooltip": "This changes the reaction of the 'fine speed' input to extreme physical speed. You will see the difference best if 'fine speed' is mapped to the radius.\n-8.0 very fast speed does not increase 'fine speed' much more\n+8.0 very fast speed increases 'fine speed' a lot\nFor very slow speed the opposite happens."
},
{
"constant": true,
"default": 4.0,
"displayed_name": "Gross speed gamma",
"internal_name": "speed2_gamma",
"maximum": 8.0,
"minimum": -8.0,
"tooltip": "Same as 'fine speed gamma' for gross speed"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Jitter",
"internal_name": "offset_by_random",
"maximum": 25.0,
"minimum": 0.0,
"tooltip": "Add a random offset to the position where each dab is drawn\n 0.0 disabled\n 1.0 standard deviation is one basic radius away\n<0.0 negative values produce no jitter"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Offset by speed",
"internal_name": "offset_by_speed",
"maximum": 3.0,
"minimum": -3.0,
"tooltip": "Change position depending on pointer speed\n= 0 disable\n> 0 draw where the pointer moves to\n< 0 draw where the pointer comes from"
},
{
"constant": false,
"default": 1.0,
"displayed_name": "Offset by speed filter",
"internal_name": "offset_by_speed_slowness",
"maximum": 15.0,
"minimum": 0.0,
"tooltip": "How slow the offset goes back to zero when the cursor stops moving"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Slow position tracking",
"internal_name": "slow_tracking",
"maximum": 10.0,
"minimum": 0.0,
"tooltip": "Slowdown pointer tracking speed. 0 disables it, higher values remove more jitter in cursor movements. Useful for drawing smooth, comic-like outlines."
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Slow tracking per dab",
"internal_name": "slow_tracking_per_dab",
"maximum": 10.0,
"minimum": 0.0,
"tooltip": "Similar as above but at brushdab level (ignoring how much time has passed if brushdabs do not depend on time)"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Tracking noise",
"internal_name": "tracking_noise",
"maximum": 12.0,
"minimum": 0.0,
"tooltip": "Add randomness to the mouse pointer; this usually generates many small lines in random directions; maybe try this together with 'slow tracking'"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Color hue",
"internal_name": "color_h",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Color hue"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Color saturation",
"internal_name": "color_s",
"maximum": 1.5,
"minimum": -0.5,
"tooltip": "Color saturation"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Color value",
"internal_name": "color_v",
"maximum": 1.5,
"minimum": -0.5,
"tooltip": "Color value (brightness, intensity)"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Save color",
"internal_name": "restore_color",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "When selecting a brush, the color can be restored to the color that the brush was saved with.\n 0.0 do not modify the active color when selecting this brush\n 0.5 change active color towards brush color\n 1.0 set the active color to the brush color when selected"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Change color hue",
"internal_name": "change_color_h",
"maximum": 2.0,
"minimum": -2.0,
"tooltip": "Change color hue.\n-0.1 small clockwise color hue shift\n 0.0 disable\n 0.5 counterclockwise hue shift by 180 degrees"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Change color lightness (HSL)",
"internal_name": "change_color_l",
"maximum": 2.0,
"minimum": -2.0,
"tooltip": "Change the color lightness using the HSL color model.\n-1.0 blacker\n 0.0 disable\n 1.0 whiter"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Change color satur. (HSL)",
"internal_name": "change_color_hsl_s",
"maximum": 2.0,
"minimum": -2.0,
"tooltip": "Change the color saturation using the HSL color model.\n-1.0 more grayish\n 0.0 disable\n 1.0 more saturated"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Change color value (HSV)",
"internal_name": "change_color_v",
"maximum": 2.0,
"minimum": -2.0,
"tooltip": "Change the color value (brightness, intensity) using the HSV color model. HSV changes are applied before HSL.\n-1.0 darker\n 0.0 disable\n 1.0 brigher"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Change color satur. (HSV)",
"internal_name": "change_color_hsv_s",
"maximum": 2.0,
"minimum": -2.0,
"tooltip": "Change the color saturation using the HSV color model. HSV changes are applied before HSL.\n-1.0 more grayish\n 0.0 disable\n 1.0 more saturated"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Smudge",
"internal_name": "smudge",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Paint with the smudge color instead of the brush color. The smudge color is slowly changed to the color you are painting on.\n 0.0 do not use the smudge color\n 0.5 mix the smudge color with the brush color\n 1.0 use only the smudge color"
},
{
"constant": false,
"default": 0.5,
"displayed_name": "Smudge length",
"internal_name": "smudge_length",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "This controls how fast the smudge color becomes the color you are painting on.\n0.0 immediately update the smudge color (requires more CPU cycles because of the frequent color checks)\n0.5 change the smudge color steadily towards the canvas color\n1.0 never change the smudge color"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Smudge radius",
"internal_name": "smudge_radius_log",
"maximum": 1.6,
"minimum": -1.6,
"tooltip": "This modifies the radius of the circle where color is picked up for smudging.\n 0.0 use the brush radius\n-0.7 half the brush radius (fast, but not always intuitive)\n+0.7 twice the brush radius\n+1.6 five times the brush radius (slow performance)"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Eraser",
"internal_name": "eraser",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "how much this tool behaves like an eraser\n 0.0 normal painting\n 1.0 standard eraser\n 0.5 pixels go towards 50% transparency"
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Stroke threshold",
"internal_name": "stroke_threshold",
"maximum": 0.5,
"minimum": 0.0,
"tooltip": "How much pressure is needed to start a stroke. This affects the stroke input only. MyPaint does not need a minimum pressure to start drawing."
},
{
"constant": false,
"default": 4.0,
"displayed_name": "Stroke duration",
"internal_name": "stroke_duration_logarithmic",
"maximum": 7.0,
"minimum": -1.0,
"tooltip": "How far you have to move until the stroke input reaches 1.0. This value is logarithmic (negative values will not invert the process)."
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Stroke hold time",
"internal_name": "stroke_holdtime",
"maximum": 10.0,
"minimum": 0.0,
"tooltip": "This defines how long the stroke input stays at 1.0. After that it will reset to 0.0 and start growing again, even if the stroke is not yet finished.\n2.0 means twice as long as it takes to go from 0.0 to 1.0\n9.9 or higher stands for infinite"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Custom input",
"internal_name": "custom_input",
"maximum": 5.0,
"minimum": -5.0,
"tooltip": "Set the custom input to this value. If it is slowed down, move it towards this value (see below). The idea is that you make this input depend on a mixture of pressure/speed/whatever, and then make other settings depend on this 'custom input' instead of repeating this combination everywhere you need it.\nIf you make it change 'by random' you can generate a slow (smooth) random input."
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Custom input filter",
"internal_name": "custom_input_slowness",
"maximum": 10.0,
"minimum": 0.0,
"tooltip": "How slow the custom input actually follows the desired value (the one above). This happens at brushdab level (ignoring how much time has passed, if brushdabs do not depend on time).\n0.0 no slowdown (changes apply instantly)"
},
{
"constant": false,
"default": 1.0,
"displayed_name": "Elliptical dab: ratio",
"internal_name": "elliptical_dab_ratio",
"maximum": 10.0,
"minimum": 1.0,
"tooltip": "Aspect ratio of the dabs; must be >= 1.0, where 1.0 means a perfectly round dab. TODO: linearize? start at 0.0 maybe, or log?"
},
{
"constant": false,
"default": 90.0,
"displayed_name": "Elliptical dab: angle",
"internal_name": "elliptical_dab_angle",
"maximum": 180.0,
"minimum": 0.0,
"tooltip": "Angle by which elliptical dabs are tilted\n 0.0 horizontal dabs\n 45.0 45 degrees, turned clockwise\n 180.0 horizontal again"
},
{
"constant": false,
"default": 2.0,
"displayed_name": "Direction filter",
"internal_name": "direction_filter",
"maximum": 10.0,
"minimum": 0.0,
"tooltip": "A low value will make the direction input adapt more quickly, a high value will make it smoother"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Lock alpha",
"internal_name": "lock_alpha",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Do not modify the alpha channel of the layer (paint only where there is paint already)\n 0.0 normal painting\n 0.5 half of the paint gets applied normally\n 1.0 alpha channel fully locked"
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Colorize",
"internal_name": "colorize",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Colorize the target layer, setting its hue and saturation from the active brush color while retaining its value and alpha."
},
{
"constant": false,
"default": 0.0,
"displayed_name": "Snap to pixel",
"internal_name": "snap_to_pixel",
"maximum": 1.0,
"minimum": 0.0,
"tooltip": "Snap brush dab's center and its radius to pixels. Set this to 1.0 for a thin pixel brush."
},
{
"constant": true,
"default": 0.0,
"displayed_name": "Pressure gain",
"internal_name": "pressure_gain_log",
"maximum": 1.8,
"minimum": -1.8,
"tooltip": "This changes how hard you have to press. It multiplies tablet pressure by a constant factor."
}
],
"states__comment": "# WARNING: only append to this list, for compatibility of replay files (brush.get_state() in stroke.py)",
"states": [
"x",
"y",
"pressure",
"partial_dabs",
"actual_radius",
"smudge_ra",
"smudge_ga",
"smudge_ba",
"smudge_a",
"last_getcolor_r",
"last_getcolor_g",
"last_getcolor_b",
"last_getcolor_a",
"last_getcolor_recentness",
"actual_x",
"actual_y",
"norm_dx_slow",
"norm_dy_slow",
"norm_speed1_slow",
"norm_speed2_slow",
"stroke",
"stroke_started",
"custom_input",
"rng_seed",
"actual_elliptical_dab_ratio",
"actual_elliptical_dab_angle",
"direction_dx",
"direction_dy",
"declination",
"ascension"
]
}