From a62db7f9c2b439c95bc5425411dde10e6baff822 Mon Sep 17 00:00:00 2001
From: Bill Kendrick
Date: Mon, 14 Oct 2024 17:08:31 -0700
Subject: [PATCH] Tweaks to `w3m.sh` to improve TXT version of docs
Make headers and description terms more apparent, by adding
some more regexps into the `sed` that the HTML is piped through
before being sent to `w3m`.
---
docs/CHANGES.txt | 7 +-
docs/en/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/en/ENVVARS.txt | 38 +-
docs/en/EXTENDING.txt | 171 ++---
docs/en/FAQ.txt | 148 ++--
docs/en/INSTALL.txt | 172 ++---
docs/en/MAGIC-API.txt | 690 +++++++++---------
docs/en/OPTIONS.txt | 546 +++++++-------
docs/en/PNG.txt | 26 +-
docs/en/README.txt | 346 ++++-----
docs/en/SIGNALS.txt | 8 +-
docs/en/SVG.txt | 6 +-
docs/en/html/EXTENDING.html | 5 +
docs/en/html/README.html | 49 +-
docs/en/tuxpaint-quickstart-guide.txt | 40 +-
docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/es_ES.UTF-8/ENVVARS.txt | 38 +-
docs/es_ES.UTF-8/EXTENDING.txt | 171 ++---
docs/es_ES.UTF-8/FAQ.txt | 148 ++--
docs/es_ES.UTF-8/INSTALL.txt | 172 ++---
docs/es_ES.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/es_ES.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/es_ES.UTF-8/PNG.txt | 26 +-
docs/es_ES.UTF-8/README.txt | 346 ++++-----
docs/es_ES.UTF-8/SIGNALS.txt | 8 +-
docs/es_ES.UTF-8/SVG.txt | 6 +-
docs/es_ES.UTF-8/html/EXTENDING.html | 5 +
docs/es_ES.UTF-8/html/README.html | 49 +-
.../es_ES.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/fr_FR.UTF-8/ENVVARS.txt | 38 +-
docs/fr_FR.UTF-8/EXTENDING.txt | 171 ++---
docs/fr_FR.UTF-8/FAQ.txt | 158 ++--
docs/fr_FR.UTF-8/INSTALL.txt | 173 ++---
docs/fr_FR.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/fr_FR.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/fr_FR.UTF-8/PNG.txt | 26 +-
docs/fr_FR.UTF-8/README.txt | 346 ++++-----
docs/fr_FR.UTF-8/SIGNALS.txt | 9 +-
docs/fr_FR.UTF-8/SVG.txt | 6 +-
docs/fr_FR.UTF-8/html/EXTENDING.html | 5 +
docs/fr_FR.UTF-8/html/README.html | 49 +-
.../fr_FR.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/gl_ES.UTF-8/ENVVARS.txt | 38 +-
docs/gl_ES.UTF-8/EXTENDING.txt | 171 ++---
docs/gl_ES.UTF-8/FAQ.txt | 151 ++--
docs/gl_ES.UTF-8/INSTALL.txt | 173 ++---
docs/gl_ES.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/gl_ES.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/gl_ES.UTF-8/PNG.txt | 26 +-
docs/gl_ES.UTF-8/README.txt | 346 ++++-----
docs/gl_ES.UTF-8/SIGNALS.txt | 8 +-
docs/gl_ES.UTF-8/SVG.txt | 6 +-
docs/gl_ES.UTF-8/html/EXTENDING.html | 5 +
docs/gl_ES.UTF-8/html/README.html | 49 +-
.../gl_ES.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/is_IS.UTF-8/ENVVARS.txt | 38 +-
docs/is_IS.UTF-8/EXTENDING.txt | 171 ++---
docs/is_IS.UTF-8/FAQ.txt | 148 ++--
docs/is_IS.UTF-8/INSTALL.txt | 172 ++---
docs/is_IS.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/is_IS.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/is_IS.UTF-8/PNG.txt | 26 +-
docs/is_IS.UTF-8/README.txt | 346 ++++-----
docs/is_IS.UTF-8/SIGNALS.txt | 8 +-
docs/is_IS.UTF-8/SVG.txt | 6 +-
docs/is_IS.UTF-8/html/EXTENDING.html | 5 +
docs/is_IS.UTF-8/html/README.html | 49 +-
.../is_IS.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/ja_JP.UTF-8/ENVVARS.txt | 38 +-
docs/ja_JP.UTF-8/EXTENDING.txt | 171 ++---
docs/ja_JP.UTF-8/FAQ.txt | 148 ++--
docs/ja_JP.UTF-8/INSTALL.txt | 172 ++---
docs/ja_JP.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/ja_JP.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/ja_JP.UTF-8/PNG.txt | 26 +-
docs/ja_JP.UTF-8/README.txt | 346 ++++-----
docs/ja_JP.UTF-8/SIGNALS.txt | 8 +-
docs/ja_JP.UTF-8/SVG.txt | 6 +-
docs/ja_JP.UTF-8/html/EXTENDING.html | 5 +
docs/ja_JP.UTF-8/html/README.html | 49 +-
.../ja_JP.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/sq_AL.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 18 +-
docs/sq_AL.UTF-8/ENVVARS.txt | 38 +-
docs/sq_AL.UTF-8/EXTENDING.txt | 171 ++---
docs/sq_AL.UTF-8/FAQ.txt | 151 ++--
docs/sq_AL.UTF-8/INSTALL.txt | 172 ++---
docs/sq_AL.UTF-8/MAGIC-API.txt | 690 +++++++++---------
docs/sq_AL.UTF-8/OPTIONS.txt | 546 +++++++-------
docs/sq_AL.UTF-8/PNG.txt | 26 +-
docs/sq_AL.UTF-8/README.txt | 346 ++++-----
docs/sq_AL.UTF-8/SIGNALS.txt | 8 +-
docs/sq_AL.UTF-8/SVG.txt | 6 +-
docs/sq_AL.UTF-8/html/EXTENDING.html | 5 +
docs/sq_AL.UTF-8/html/README.html | 49 +-
.../sq_AL.UTF-8/tuxpaint-quickstart-guide.txt | 40 +-
docs/w3m.sh | 37 +-
magic/magic-docs/en/1pt_perspective.txt | 4 +-
.../magic-docs/en/1pt_perspective_select.txt | 4 +-
magic/magic-docs/en/2pt_perspective.txt | 4 +-
.../magic-docs/en/2pt_perspective_select.txt | 4 +-
magic/magic-docs/en/3dglasses.txt | 4 +-
magic/magic-docs/en/3pt_perspective.txt | 4 +-
.../magic-docs/en/3pt_perspective_select.txt | 4 +-
magic/magic-docs/en/ascii_color_computer.txt | 4 +-
magic/magic-docs/en/ascii_computer.txt | 4 +-
magic/magic-docs/en/ascii_typewriter.txt | 4 +-
magic/magic-docs/en/blinds.txt | 4 +-
magic/magic-docs/en/blocks.txt | 5 +-
magic/magic-docs/en/bloom.txt | 4 +-
magic/magic-docs/en/blur.txt | 5 +-
magic/magic-docs/en/bricks.txt | 4 +-
magic/magic-docs/en/calligraphy.txt | 4 +-
magic/magic-docs/en/cartoon.txt | 4 +-
magic/magic-docs/en/chalk.txt | 4 +-
magic/magic-docs/en/checkerboard.txt | 4 +-
magic/magic-docs/en/circles.txt | 4 +-
magic/magic-docs/en/clone.txt | 4 +-
magic/magic-docs/en/color_and_white.txt | 4 +-
magic/magic-docs/en/color_shift.txt | 4 +-
magic/magic-docs/en/colorsep.txt | 4 +-
magic/magic-docs/en/comic_dots.txt | 4 +-
magic/magic-docs/en/concentric-circle.txt | 4 +-
magic/magic-docs/en/concentric-square.txt | 4 +-
magic/magic-docs/en/confetti.txt | 4 +-
magic/magic-docs/en/crescent.txt | 4 +-
magic/magic-docs/en/darken.txt | 4 +-
magic/magic-docs/en/desaturate.txt | 4 +-
magic/magic-docs/en/dimetric_draw.txt | 4 +-
magic/magic-docs/en/dimetric_select.txt | 4 +-
magic/magic-docs/en/distortion.txt | 4 +-
magic/magic-docs/en/dither.txt | 4 +-
magic/magic-docs/en/dither_keep_colors.txt | 4 +-
magic/magic-docs/en/doublevision.txt | 4 +-
magic/magic-docs/en/drip.txt | 4 +-
magic/magic-docs/en/edges.txt | 4 +-
magic/magic-docs/en/emboss.txt | 4 +-
magic/magic-docs/en/epitrochoid.txt | 4 +-
magic/magic-docs/en/epitrochoid_edge.txt | 4 +-
magic/magic-docs/en/epitrochoid_inside.txt | 4 +-
magic/magic-docs/en/epitrochoid_outside.txt | 4 +-
magic/magic-docs/en/fill.txt | 2 +-
magic/magic-docs/en/filled_polygon.txt | 4 +-
magic/magic-docs/en/fisheye.txt | 4 +-
magic/magic-docs/en/flip.txt | 4 +-
magic/magic-docs/en/flower.txt | 4 +-
magic/magic-docs/en/foam.txt | 4 +-
magic/magic-docs/en/fold.txt | 5 +-
magic/magic-docs/en/fractal.txt | 4 +-
magic/magic-docs/en/fretwork.txt | 4 +-
magic/magic-docs/en/fur.txt | 4 +-
magic/magic-docs/en/glass_tile.txt | 4 +-
magic/magic-docs/en/googlyeyes.txt | 4 +-
magic/magic-docs/en/grass.txt | 4 +-
magic/magic-docs/en/halftone.txt | 4 +-
magic/magic-docs/en/hexagon_mosaic.txt | 4 +-
magic/magic-docs/en/hypotrochoid.txt | 4 +-
magic/magic-docs/en/hypotrochoid_edge.txt | 4 +-
magic/magic-docs/en/hypotrochoid_inside.txt | 4 +-
magic/magic-docs/en/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/en/index.txt | 16 +-
magic/magic-docs/en/irregular_mosaic.txt | 4 +-
magic/magic-docs/en/isometric_line.txt | 4 +-
magic/magic-docs/en/kaleidoscope.txt | 4 +-
magic/magic-docs/en/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/en/keep_color.txt | 4 +-
magic/magic-docs/en/light.txt | 4 +-
magic/magic-docs/en/lighten.txt | 4 +-
magic/magic-docs/en/lightning.txt | 4 +-
magic/magic-docs/en/loops.txt | 4 +-
magic/magic-docs/en/maze.txt | 4 +-
magic/magic-docs/en/metal_paint.txt | 4 +-
magic/magic-docs/en/mirror.txt | 4 +-
magic/magic-docs/en/mosaic.txt | 5 +-
magic/magic-docs/en/negative.txt | 4 +-
magic/magic-docs/en/noise.txt | 4 +-
magic/magic-docs/en/oblique_draw.txt | 4 +-
magic/magic-docs/en/oblique_select.txt | 4 +-
magic/magic-docs/en/opposite.txt | 4 +-
magic/magic-docs/en/panels.txt | 4 +-
magic/magic-docs/en/pattern.txt | 4 +-
magic/magic-docs/en/perspective.txt | 4 +-
magic/magic-docs/en/picasso.txt | 4 +-
magic/magic-docs/en/pixels.txt | 4 +-
magic/magic-docs/en/puzzle.txt | 4 +-
magic/magic-docs/en/rails.txt | 5 +-
magic/magic-docs/en/rain.txt | 4 +-
magic/magic-docs/en/rainbow.txt | 4 +-
magic/magic-docs/en/rainbow_cycle.txt | 4 +-
magic/magic-docs/en/rays.txt | 4 +-
magic/magic-docs/en/real_rainbow.txt | 4 +-
magic/magic-docs/en/reflection.txt | 4 +-
magic/magic-docs/en/remove_color.txt | 4 +-
magic/magic-docs/en/ribbon.txt | 4 +-
magic/magic-docs/en/ripples.txt | 4 +-
magic/magic-docs/en/rosette.txt | 4 +-
magic/magic-docs/en/rotate.txt | 4 +-
magic/magic-docs/en/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/en/rush.txt | 5 +-
magic/magic-docs/en/saturate.txt | 4 +-
magic/magic-docs/en/sharpen.txt | 4 +-
magic/magic-docs/en/shift.txt | 4 +-
magic/magic-docs/en/silhouette.txt | 4 +-
magic/magic-docs/en/smooth.txt | 4 +-
magic/magic-docs/en/smooth_rainbow.txt | 4 +-
magic/magic-docs/en/smudge.txt | 4 +-
magic/magic-docs/en/snow_ball.txt | 4 +-
magic/magic-docs/en/snow_flake.txt | 4 +-
magic/magic-docs/en/spiral-square.txt | 4 +-
magic/magic-docs/en/spiral.txt | 4 +-
magic/magic-docs/en/spraypaint.txt | 4 +-
magic/magic-docs/en/square_mosaic.txt | 4 +-
magic/magic-docs/en/squiggles.txt | 4 +-
magic/magic-docs/en/stretch.txt | 4 +-
magic/magic-docs/en/string_corner.txt | 4 +-
magic/magic-docs/en/string_edges.txt | 4 +-
magic/magic-docs/en/string_v.txt | 4 +-
magic/magic-docs/en/symmetry_left_right.txt | 4 +-
magic/magic-docs/en/symmetry_up_down.txt | 4 +-
magic/magic-docs/en/tessellation-flat.txt | 4 +-
magic/magic-docs/en/tessellation-pointy.txt | 4 +-
magic/magic-docs/en/tiles.txt | 4 +-
magic/magic-docs/en/tilezoom.txt | 5 +-
magic/magic-docs/en/tint.txt | 4 +-
magic/magic-docs/en/toothpaste.txt | 4 +-
magic/magic-docs/en/tornado.txt | 4 +-
magic/magic-docs/en/trimetric_draw.txt | 4 +-
magic/magic-docs/en/trimetric_select.txt | 4 +-
magic/magic-docs/en/tv.txt | 5 +-
magic/magic-docs/en/tv_bright.txt | 5 +-
magic/magic-docs/en/wavelets.txt | 5 +-
magic/magic-docs/en/waves.txt | 4 +-
magic/magic-docs/en/wet_paint.txt | 5 +-
magic/magic-docs/en/xor_colors.txt | 4 +-
magic/magic-docs/en/zoom.txt | 4 +-
.../es_ES.UTF-8/1pt_perspective.txt | 4 +-
.../es_ES.UTF-8/1pt_perspective_select.txt | 4 +-
.../es_ES.UTF-8/2pt_perspective.txt | 4 +-
.../es_ES.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/3dglasses.txt | 4 +-
.../es_ES.UTF-8/3pt_perspective.txt | 4 +-
.../es_ES.UTF-8/3pt_perspective_select.txt | 4 +-
.../es_ES.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/es_ES.UTF-8/ascii_computer.txt | 4 +-
.../es_ES.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/blinds.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/blocks.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/bloom.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/blur.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/bricks.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/chalk.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/circles.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/clone.txt | 4 +-
.../es_ES.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/comic_dots.txt | 4 +-
.../es_ES.UTF-8/concentric-circle.txt | 4 +-
.../es_ES.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/confetti.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/crescent.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/darken.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/desaturate.txt | 4 +-
.../magic-docs/es_ES.UTF-8/dimetric_draw.txt | 4 +-
.../es_ES.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/distortion.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/dither.txt | 4 +-
.../es_ES.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/drip.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/edges.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/emboss.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/epitrochoid.txt | 4 +-
.../es_ES.UTF-8/epitrochoid_edge.txt | 4 +-
.../es_ES.UTF-8/epitrochoid_inside.txt | 4 +-
.../es_ES.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/es_ES.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/flip.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/flower.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/foam.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/fold.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/fractal.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/fur.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/grass.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/halftone.txt | 4 +-
.../magic-docs/es_ES.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/hypotrochoid.txt | 4 +-
.../es_ES.UTF-8/hypotrochoid_edge.txt | 4 +-
.../es_ES.UTF-8/hypotrochoid_inside.txt | 4 +-
.../es_ES.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/index.txt | 16 +-
.../es_ES.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/es_ES.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/kaleidoscope.txt | 4 +-
.../es_ES.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/light.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/lighten.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/lightning.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/loops.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/maze.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/mirror.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/negative.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/noise.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/es_ES.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/opposite.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/panels.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/pattern.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/perspective.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/picasso.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/pixels.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rails.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/rain.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rainbow.txt | 4 +-
.../magic-docs/es_ES.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rays.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/reflection.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/ripples.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rosette.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rotate.txt | 4 +-
.../es_ES.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/rush.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/saturate.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/shift.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/smooth.txt | 4 +-
.../magic-docs/es_ES.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/smudge.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/es_ES.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/spiral.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/es_ES.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/stretch.txt | 4 +-
.../magic-docs/es_ES.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/string_v.txt | 4 +-
.../es_ES.UTF-8/symmetry_left_right.txt | 4 +-
.../es_ES.UTF-8/symmetry_up_down.txt | 4 +-
.../es_ES.UTF-8/tessellation-flat.txt | 4 +-
.../es_ES.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/tiles.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/tint.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/tornado.txt | 4 +-
.../magic-docs/es_ES.UTF-8/trimetric_draw.txt | 4 +-
.../es_ES.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/tv.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/waves.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/es_ES.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/es_ES.UTF-8/zoom.txt | 4 +-
.../fr_FR.UTF-8/1pt_perspective.txt | 4 +-
.../fr_FR.UTF-8/1pt_perspective_select.txt | 4 +-
.../fr_FR.UTF-8/2pt_perspective.txt | 4 +-
.../fr_FR.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/3dglasses.txt | 4 +-
.../fr_FR.UTF-8/3pt_perspective.txt | 4 +-
.../fr_FR.UTF-8/3pt_perspective_select.txt | 4 +-
.../fr_FR.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/ascii_computer.txt | 4 +-
.../fr_FR.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/blinds.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/blocks.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/bloom.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/blur.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/bricks.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/chalk.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/circles.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/clone.txt | 4 +-
.../fr_FR.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/comic_dots.txt | 4 +-
.../fr_FR.UTF-8/concentric-circle.txt | 4 +-
.../fr_FR.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/confetti.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/crescent.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/darken.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/desaturate.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/dimetric_draw.txt | 4 +-
.../fr_FR.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/distortion.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/dither.txt | 4 +-
.../fr_FR.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/drip.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/edges.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/emboss.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/epitrochoid.txt | 4 +-
.../fr_FR.UTF-8/epitrochoid_edge.txt | 4 +-
.../fr_FR.UTF-8/epitrochoid_inside.txt | 4 +-
.../fr_FR.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/flip.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/flower.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/foam.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/fold.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/fractal.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/fur.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/grass.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/halftone.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/hypotrochoid.txt | 4 +-
.../fr_FR.UTF-8/hypotrochoid_edge.txt | 4 +-
.../fr_FR.UTF-8/hypotrochoid_inside.txt | 4 +-
.../fr_FR.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/index.txt | 16 +-
.../fr_FR.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/kaleidoscope.txt | 4 +-
.../fr_FR.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/light.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/lighten.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/lightning.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/loops.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/maze.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/mirror.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/negative.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/noise.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/opposite.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/panels.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/pattern.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/perspective.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/picasso.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/pixels.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rails.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/rain.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rainbow.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rays.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/reflection.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/ripples.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rosette.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rotate.txt | 4 +-
.../fr_FR.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/rush.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/saturate.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/shift.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/smooth.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/smudge.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/spiral.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/stretch.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/string_v.txt | 4 +-
.../fr_FR.UTF-8/symmetry_left_right.txt | 4 +-
.../fr_FR.UTF-8/symmetry_up_down.txt | 4 +-
.../fr_FR.UTF-8/tessellation-flat.txt | 4 +-
.../fr_FR.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/tiles.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/tint.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/tornado.txt | 4 +-
.../magic-docs/fr_FR.UTF-8/trimetric_draw.txt | 4 +-
.../fr_FR.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/tv.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/waves.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/fr_FR.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/fr_FR.UTF-8/zoom.txt | 4 +-
.../gl_ES.UTF-8/1pt_perspective.txt | 4 +-
.../gl_ES.UTF-8/1pt_perspective_select.txt | 4 +-
.../gl_ES.UTF-8/2pt_perspective.txt | 4 +-
.../gl_ES.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/3dglasses.txt | 4 +-
.../gl_ES.UTF-8/3pt_perspective.txt | 4 +-
.../gl_ES.UTF-8/3pt_perspective_select.txt | 4 +-
.../gl_ES.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/ascii_computer.txt | 4 +-
.../gl_ES.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/blinds.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/blocks.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/bloom.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/blur.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/bricks.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/chalk.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/circles.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/clone.txt | 4 +-
.../gl_ES.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/comic_dots.txt | 4 +-
.../gl_ES.UTF-8/concentric-circle.txt | 4 +-
.../gl_ES.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/confetti.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/crescent.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/darken.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/desaturate.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/dimetric_draw.txt | 4 +-
.../gl_ES.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/distortion.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/dither.txt | 4 +-
.../gl_ES.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/drip.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/edges.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/emboss.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/epitrochoid.txt | 4 +-
.../gl_ES.UTF-8/epitrochoid_edge.txt | 4 +-
.../gl_ES.UTF-8/epitrochoid_inside.txt | 4 +-
.../gl_ES.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/flip.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/flower.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/foam.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/fold.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/fractal.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/fur.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/grass.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/halftone.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/hypotrochoid.txt | 4 +-
.../gl_ES.UTF-8/hypotrochoid_edge.txt | 4 +-
.../gl_ES.UTF-8/hypotrochoid_inside.txt | 4 +-
.../gl_ES.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/index.txt | 16 +-
.../gl_ES.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/kaleidoscope.txt | 4 +-
.../gl_ES.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/light.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/lighten.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/lightning.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/loops.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/maze.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/mirror.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/negative.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/noise.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/opposite.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/panels.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/pattern.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/perspective.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/picasso.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/pixels.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rails.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/rain.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rainbow.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rays.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/reflection.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/ripples.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rosette.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rotate.txt | 4 +-
.../gl_ES.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/rush.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/saturate.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/shift.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/smooth.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/smudge.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/spiral.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/stretch.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/string_v.txt | 4 +-
.../gl_ES.UTF-8/symmetry_left_right.txt | 4 +-
.../gl_ES.UTF-8/symmetry_up_down.txt | 4 +-
.../gl_ES.UTF-8/tessellation-flat.txt | 4 +-
.../gl_ES.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/tiles.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/tint.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/tornado.txt | 4 +-
.../magic-docs/gl_ES.UTF-8/trimetric_draw.txt | 4 +-
.../gl_ES.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/tv.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/waves.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/gl_ES.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/gl_ES.UTF-8/zoom.txt | 4 +-
.../is_IS.UTF-8/1pt_perspective.txt | 4 +-
.../is_IS.UTF-8/1pt_perspective_select.txt | 4 +-
.../is_IS.UTF-8/2pt_perspective.txt | 4 +-
.../is_IS.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/3dglasses.txt | 4 +-
.../is_IS.UTF-8/3pt_perspective.txt | 4 +-
.../is_IS.UTF-8/3pt_perspective_select.txt | 4 +-
.../is_IS.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/is_IS.UTF-8/ascii_computer.txt | 4 +-
.../is_IS.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/blinds.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/blocks.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/bloom.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/blur.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/bricks.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/chalk.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/circles.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/clone.txt | 4 +-
.../is_IS.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/comic_dots.txt | 4 +-
.../is_IS.UTF-8/concentric-circle.txt | 4 +-
.../is_IS.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/confetti.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/crescent.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/darken.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/desaturate.txt | 4 +-
.../magic-docs/is_IS.UTF-8/dimetric_draw.txt | 4 +-
.../is_IS.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/distortion.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/dither.txt | 4 +-
.../is_IS.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/drip.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/edges.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/emboss.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/epitrochoid.txt | 4 +-
.../is_IS.UTF-8/epitrochoid_edge.txt | 4 +-
.../is_IS.UTF-8/epitrochoid_inside.txt | 4 +-
.../is_IS.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/is_IS.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/flip.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/flower.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/foam.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/fold.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/fractal.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/fur.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/grass.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/halftone.txt | 4 +-
.../magic-docs/is_IS.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/hypotrochoid.txt | 4 +-
.../is_IS.UTF-8/hypotrochoid_edge.txt | 4 +-
.../is_IS.UTF-8/hypotrochoid_inside.txt | 4 +-
.../is_IS.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/index.txt | 16 +-
.../is_IS.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/is_IS.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/kaleidoscope.txt | 4 +-
.../is_IS.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/light.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/lighten.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/lightning.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/loops.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/maze.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/mirror.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/negative.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/noise.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/is_IS.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/opposite.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/panels.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/pattern.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/perspective.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/picasso.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/pixels.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rails.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/rain.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rainbow.txt | 4 +-
.../magic-docs/is_IS.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rays.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/reflection.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/ripples.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rosette.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rotate.txt | 4 +-
.../is_IS.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/rush.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/saturate.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/shift.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/smooth.txt | 4 +-
.../magic-docs/is_IS.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/smudge.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/is_IS.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/spiral.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/is_IS.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/stretch.txt | 4 +-
.../magic-docs/is_IS.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/string_v.txt | 4 +-
.../is_IS.UTF-8/symmetry_left_right.txt | 4 +-
.../is_IS.UTF-8/symmetry_up_down.txt | 4 +-
.../is_IS.UTF-8/tessellation-flat.txt | 4 +-
.../is_IS.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/tiles.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/tint.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/tornado.txt | 4 +-
.../magic-docs/is_IS.UTF-8/trimetric_draw.txt | 4 +-
.../is_IS.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/tv.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/waves.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/is_IS.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/is_IS.UTF-8/zoom.txt | 4 +-
.../ja_JP.UTF-8/1pt_perspective.txt | 4 +-
.../ja_JP.UTF-8/1pt_perspective_select.txt | 4 +-
.../ja_JP.UTF-8/2pt_perspective.txt | 4 +-
.../ja_JP.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/3dglasses.txt | 4 +-
.../ja_JP.UTF-8/3pt_perspective.txt | 4 +-
.../ja_JP.UTF-8/3pt_perspective_select.txt | 4 +-
.../ja_JP.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/ascii_computer.txt | 4 +-
.../ja_JP.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/blinds.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/blocks.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/bloom.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/blur.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/bricks.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/chalk.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/circles.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/clone.txt | 4 +-
.../ja_JP.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/comic_dots.txt | 4 +-
.../ja_JP.UTF-8/concentric-circle.txt | 4 +-
.../ja_JP.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/confetti.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/crescent.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/darken.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/desaturate.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/dimetric_draw.txt | 4 +-
.../ja_JP.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/distortion.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/dither.txt | 4 +-
.../ja_JP.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/drip.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/edges.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/emboss.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/epitrochoid.txt | 4 +-
.../ja_JP.UTF-8/epitrochoid_edge.txt | 4 +-
.../ja_JP.UTF-8/epitrochoid_inside.txt | 4 +-
.../ja_JP.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/flip.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/flower.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/foam.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/fold.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/fractal.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/fur.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/grass.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/halftone.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/hypotrochoid.txt | 4 +-
.../ja_JP.UTF-8/hypotrochoid_edge.txt | 4 +-
.../ja_JP.UTF-8/hypotrochoid_inside.txt | 4 +-
.../ja_JP.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/index.txt | 16 +-
.../ja_JP.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/kaleidoscope.txt | 4 +-
.../ja_JP.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/light.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/lighten.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/lightning.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/loops.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/maze.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/mirror.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/negative.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/noise.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/opposite.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/panels.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/pattern.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/perspective.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/picasso.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/pixels.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rails.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/rain.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rainbow.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rays.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/reflection.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/ripples.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rosette.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rotate.txt | 4 +-
.../ja_JP.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/rush.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/saturate.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/shift.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/smooth.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/smudge.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/spiral.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/stretch.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/string_v.txt | 4 +-
.../ja_JP.UTF-8/symmetry_left_right.txt | 4 +-
.../ja_JP.UTF-8/symmetry_up_down.txt | 4 +-
.../ja_JP.UTF-8/tessellation-flat.txt | 4 +-
.../ja_JP.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/tiles.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/tint.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/tornado.txt | 4 +-
.../magic-docs/ja_JP.UTF-8/trimetric_draw.txt | 4 +-
.../ja_JP.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/tv.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/waves.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/ja_JP.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/ja_JP.UTF-8/zoom.txt | 4 +-
.../sq_AL.UTF-8/1pt_perspective.txt | 4 +-
.../sq_AL.UTF-8/1pt_perspective_select.txt | 4 +-
.../sq_AL.UTF-8/2pt_perspective.txt | 4 +-
.../sq_AL.UTF-8/2pt_perspective_select.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/3dglasses.txt | 4 +-
.../sq_AL.UTF-8/3pt_perspective.txt | 4 +-
.../sq_AL.UTF-8/3pt_perspective_select.txt | 4 +-
.../sq_AL.UTF-8/ascii_color_computer.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/ascii_computer.txt | 4 +-
.../sq_AL.UTF-8/ascii_typewriter.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/blinds.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/blocks.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/bloom.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/blur.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/bricks.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/calligraphy.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/cartoon.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/chalk.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/checkerboard.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/circles.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/clone.txt | 4 +-
.../sq_AL.UTF-8/color_and_white.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/color_shift.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/colorsep.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/comic_dots.txt | 4 +-
.../sq_AL.UTF-8/concentric-circle.txt | 4 +-
.../sq_AL.UTF-8/concentric-square.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/confetti.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/crescent.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/darken.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/desaturate.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/dimetric_draw.txt | 4 +-
.../sq_AL.UTF-8/dimetric_select.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/distortion.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/dither.txt | 4 +-
.../sq_AL.UTF-8/dither_keep_colors.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/doublevision.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/drip.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/edges.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/emboss.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/epitrochoid.txt | 4 +-
.../sq_AL.UTF-8/epitrochoid_edge.txt | 4 +-
.../sq_AL.UTF-8/epitrochoid_inside.txt | 4 +-
.../sq_AL.UTF-8/epitrochoid_outside.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/filled_polygon.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/fisheye.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/flip.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/flower.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/foam.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/fold.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/fractal.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/fretwork.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/fur.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/glass_tile.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/googlyeyes.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/grass.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/halftone.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/hexagon_mosaic.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/hypotrochoid.txt | 4 +-
.../sq_AL.UTF-8/hypotrochoid_edge.txt | 4 +-
.../sq_AL.UTF-8/hypotrochoid_inside.txt | 4 +-
.../sq_AL.UTF-8/hypotrochoid_outside.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/index.txt | 16 +-
.../sq_AL.UTF-8/irregular_mosaic.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/isometric_line.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/kaleidoscope.txt | 4 +-
.../sq_AL.UTF-8/kaleidoscope_lens.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/keep_color.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/light.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/lighten.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/lightning.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/loops.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/maze.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/metal_paint.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/mirror.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/mosaic.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/negative.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/noise.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/oblique_draw.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/oblique_select.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/opposite.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/panels.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/pattern.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/perspective.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/picasso.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/pixels.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/puzzle.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rails.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/rain.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rainbow.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/rainbow_cycle.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rays.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/real_rainbow.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/reflection.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/remove_color.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/ribbon.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/ripples.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rosette.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rotate.txt | 4 +-
.../sq_AL.UTF-8/roygbiv_rainbow.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/rush.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/saturate.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/sharpen.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/shift.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/silhouette.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/smooth.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/smooth_rainbow.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/smudge.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/snow_ball.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/snow_flake.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/spiral-square.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/spiral.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/spraypaint.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/square_mosaic.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/squiggles.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/stretch.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/string_corner.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/string_edges.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/string_v.txt | 4 +-
.../sq_AL.UTF-8/symmetry_left_right.txt | 4 +-
.../sq_AL.UTF-8/symmetry_up_down.txt | 4 +-
.../sq_AL.UTF-8/tessellation-flat.txt | 4 +-
.../sq_AL.UTF-8/tessellation-pointy.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/tiles.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/tilezoom.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/tint.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/toothpaste.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/tornado.txt | 4 +-
.../magic-docs/sq_AL.UTF-8/trimetric_draw.txt | 4 +-
.../sq_AL.UTF-8/trimetric_select.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/tv.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/tv_bright.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/wavelets.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/waves.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/wet_paint.txt | 5 +-
magic/magic-docs/sq_AL.UTF-8/xor_colors.txt | 4 +-
magic/magic-docs/sq_AL.UTF-8/zoom.txt | 4 +-
1060 files changed, 10160 insertions(+), 9743 deletions(-)
diff --git a/docs/CHANGES.txt b/docs/CHANGES.txt
index 84469561d..4faf82636 100644
--- a/docs/CHANGES.txt
+++ b/docs/CHANGES.txt
@@ -6,7 +6,7 @@ Copyright (c) 2002-2024
Various contributors (see below, and AUTHORS.txt)
https://tuxpaint.org/
-2024.October.12 (0.9.34)
+2024.October.14 (0.9.34)
* New Magic Tools:
----------------
* "Comic Dots", draws repeating dots (using a multiply blend)
@@ -180,6 +180,11 @@ https://tuxpaint.org/
* Vietnamese translation
Cas Pascal
+ * Documentation updates:
+ ----------------------
+ * Nicer formatting of the plain text variation of documentation.
+ Bill Kendrick
+
* Bug Fixes:
----------
* Eraser choices turned from black to white when a prompt appeared.
diff --git a/docs/en/ADVANCED-STAMPS-HOWTO.txt b/docs/en/ADVANCED-STAMPS-HOWTO.txt
index be665d002..adbc4e21b 100644
--- a/docs/en/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/en/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+----------------------------------------+
-------------------------------------------------------------------------------
-About this 'How-To'
+ ### About this 'How-To' ###
This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
@@ -32,9 +32,9 @@ About this 'How-To'
-------------------------------------------------------------------------------
-Image choice is crucial
+ ### Image choice is crucial ###
- License
+ ## License ##
If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to
@@ -55,7 +55,7 @@ Image choice is crucial
For personal use, any image you can legitimately modify and use for
your own personal use should be fine.
- Image Size and Orientation
+ ## Image Size and Orientation ##
You need an image that has a useful orientation. Perspective is an
enemy. Images that show an object from the corner are difficult to fit
@@ -82,7 +82,7 @@ Image choice is crucial
-------------------------------------------------------------------------------
-Prepare the image
+ ### Prepare the image ###
First of all, be sure to avoid re-saving the image as a JPEG. This causes
quality loss. There is a special tool called jpegtran that lets you crop an
@@ -119,7 +119,7 @@ Prepare the image
-------------------------------------------------------------------------------
-Prepare the mask
+ ### Prepare the mask ###
Get used to doing [Control]-click and [Alt]-click on the thumbnail images
in the layers dialog. You will need this to control what you are looking at
@@ -178,7 +178,7 @@ Prepare the mask
-------------------------------------------------------------------------------
-Replace the fringe and junk pixels
+ ### Replace the fringe and junk pixels ###
Still viewing the mask, select by color. Choose black. Shrink the selection
by several pixels, being sure to NOT shrink from the edges of the mask (the
@@ -240,7 +240,7 @@ Replace the fringe and junk pixels
-------------------------------------------------------------------------------
-Save the image for Tux Paint
+ ### Save the image for Tux Paint ###
It is very easy to ruin your hard work. Image editors can silently destroy
pixels in 0% opaque areas. The conditions under which this happens may vary
@@ -251,7 +251,7 @@ Save the image for Tux Paint
save space (and hide your mistakes), you are almost certain to destroy all
the 0% opaque areas. So here is a better way...
- A Safer Way to Save
+ ## A Safer Way to Save ##
Drag the mask from the layers dialog to the unused portion of the
toolbar (right after the last drawing tool). This will create a new
diff --git a/docs/en/ENVVARS.txt b/docs/en/ENVVARS.txt
index 460a2ec32..195780892 100644
--- a/docs/en/ENVVARS.txt
+++ b/docs/en/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.
-Storage-related environment variables
+ ### Storage-related environment variables ###
-HOME
+→ HOME ←
Specifies the user's "home directory", which is used to locate numerous
other files or directories. In some cases, it is utilized as part of a
@@ -30,8 +30,8 @@ HOME
+ The location of a user's private collection of data files — stamps,
brushes, etc. — (versus those available system wide)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@@ -42,8 +42,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@@ -53,18 +53,18 @@ XDG_DATA_HOME
anywhere.
-
-TEMP
+
+→ TEMP ←
Specifies the location where temporary files may be created. Only used by
Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
-Language-related environment variables
+ ### Language-related environment variables ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -73,24 +73,24 @@ LC_MESSAGES
and finally "LANG".
+
-
-Display-related environment variables
+ ### Display-related environment variables ###
The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
to '1' (true) by Tux Paint itself by issuing the command-line option
"--allowscreensaver" or its configuration file counterpart.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@@ -99,5 +99,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").
-
+
diff --git a/docs/en/EXTENDING.txt b/docs/en/EXTENDING.txt
index 9dd86a062..2f5a9b499 100644
--- a/docs/en/EXTENDING.txt
+++ b/docs/en/EXTENDING.txt
@@ -44,11 +44,11 @@ changing, or removing files where Tux Paint looks for them.
Where Files Go
-Standard Files
+ ### Standard Files ###
Tux Paint looks for its various data files in its 'data' directory.
-Linux and Unix
+→ Linux and Unix ←
Where this directory goes depends on what value was set for "DATA_PREFIX"
when Tux Paint was built. See 'Install documentation' for details.
@@ -62,8 +62,8 @@ Linux and Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint looks for a directory called 'data' in the same directory as the
executable. This is the directory that the installer used when installing
@@ -72,8 +72,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint stores its data files inside the "Tux Paint" application icon
(which is actually a special kind of folder on macOS & Mac OS X before it).
@@ -106,14 +106,14 @@ macOS
Tux Paint.
+
-
-Personal Files
+ ### Personal Files ###
You can also create brushes, stamps, 'starters', templates, and fonts in your
own user account directory (folder) for Tux Paint to find.
-Windows
+→ Windows ←
Your personal Tux Paint folder is stored in your personal "Application
Data". For example, on newer Windows:
@@ -121,8 +121,8 @@ Windows
C:\Users\username\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -130,8 +130,8 @@ macOS
/Users/username/Library/Application Support/TuxPaint/
-
-Linux and Unix
+
+→ Linux and Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/username/.tuxpaint/".
@@ -139,7 +139,7 @@ Linux and Unix
Don't forget the period (".") before the "tuxpaint"!
-
+
To add your own brushes, stamps, 'starters,' templates, and fonts, create
subdirectories under your personal Tux Paint directory named "brushes", "stamps
@@ -160,7 +160,7 @@ partially-transparent!
Greyscale pixels in the brush PNG will be drawn using the currently-selected
color in Tux Paint. Color pixels will be tinted.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -170,7 +170,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -190,17 +190,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Brush Options
+ ### Brush Options ###
Aside from a graphical shape, brushes can also be given other attributes. To do
this, you need to create a 'data file' for the brush.
@@ -212,7 +212,7 @@ The file has the same name as the PNG image, but a ".dat" extension. (e.g.,
"brush.png"'s data file is the text file "brush.dat", found in the same
directory.)
-Brush Spacing
+→ Brush Spacing ←
As of Tux Paint version 0.9.16, you can now specify the spacing for brushes
(that is, how often they are drawn). By default, the spacing will be the
@@ -223,8 +223,8 @@ Brush Spacing
often the brush is drawn.)
-
-Animated Brushes
+
+→ Animated Brushes ←
As of Tux Paint version 0.9.16, you may now create animated brushes. As the
brush is used, each frame of the animation is drawn.
@@ -239,8 +239,8 @@ Animated Brushes
sequentially, also add a line containing "random" to the brush's data file.
-
-Directional Brushes
+
+→ Directional Brushes ←
As of Tux Paint version 0.9.16, you may now create directional brushes. As
the brush is used, different shapes are drawn, depending on the direction
@@ -255,8 +255,8 @@ Directional Brushes
Add a line containing the word "directional" to the brush's data file.
-
-Rotating Brushes
+
+→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@@ -265,8 +265,8 @@ Rotating Brushes
Add a line containing the word "rotate" to the brush's data file.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -274,8 +274,8 @@ Chaotic Brushes
Add a line containing the word "chaotic" to the brush's data file.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -289,7 +289,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Place the brush image PNGs (and any data text files) in the "brushes"
directory.
@@ -305,7 +305,7 @@ subdirectories and sub-subdirectories there to organize the stamps. (For
example, you can have a "holidays" folder with "halloween" and "christmas"
sub-folders.)
-Stamp Images
+ ### Stamp Images ###
Rubber Stamps in Tux Paint can be made up of a number of separate files. The
one file that is required is, of course, the picture itself.
@@ -334,7 +334,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
how to make PNG images which will scale perfectly when used as stamps in Tux
Paint.
-Stamp Descriptive Text
+ ### Stamp Descriptive Text ###
Tux Paint will display descriptive text when a stamp is selected. These are
placed in plain text files with the same name as the PNG or SVG, but with a
@@ -344,7 +344,7 @@ placed in plain text files with the same name as the PNG or SVG, but with a
The first line of the text file will be used as the US English description of
the stamp's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -364,17 +364,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Stamp Sound Effects
+ ### Stamp Sound Effects ###
Tux Paint can play a sound effect when a stamp is selected. For example, the
sound of a duck quaking when selecting a duck, or a brief piece of music when a
@@ -383,7 +383,7 @@ musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis
"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same
directory.)
-Localization Support
+→ Localization Support ←
For sounds for different locales (e.g., if the sound is someone saying a
word, and you want translated versions of the word said), also create WAV
@@ -400,12 +400,12 @@ Localization Support
the 'default' sound file. (e.g., "stamp.wav")
-
+
💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound',
below.
-Stamp Descriptive Sound
+ ### Stamp Descriptive Sound ###
Tux Paint can also play a descriptive sound when a stamp is selected. For
example, the sound of someone saying the word "duck" when selecting a duck, or
@@ -414,7 +414,7 @@ the name of a musical instrument when one is chosen. Files may be in "WAVE
or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound
is the sound file "stamp_desc.ogg" in the same directory.)
-Localization Support
+→ Localization Support ←
For descriptive sounds for different locales, also create WAV or OGG files
with both "_desc" and the locale's label in the filename, in the form:
@@ -430,9 +430,9 @@ Localization Support
load the 'default' sound file. (e.g., "stamp_desc.wav")
+
-
-Stamp Options
+ ### Stamp Options ###
Aside from a graphical shape, a textual description, a sound effect, and a
descriptive sound, stamps can also be given other attributes. To do this, you
@@ -445,11 +445,11 @@ The file has the same name as the PNG or SVG image, but a ".dat" extension.
(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same
directory.)
-Colored Stamps
+→ Colored Stamps ←
Stamps can be made to be either "colorable" or "tintable."
- Colorable
+ → Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@@ -461,8 +461,8 @@ Colored Stamps
Add a line containing the word "colorable" to the stamp's data file.
-
- Tinted
+
+ → Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@@ -472,14 +472,14 @@ Colored Stamps
Add a line containing the word "tintable" to the stamp's data file.
-
- Tinting Options:
+
+ → Tinting Options: ←
Depending on the contents of your stamp, you might want to have Tux
Paint use one of a number of methods when tinting it. Add one of the
following lines to the stamp's data file:
- Normal tinter — "tinter=normal" (the default)
+ → Normal tinter — "tinter=normal" (the default) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@@ -490,28 +490,28 @@ Colored Stamps
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
-
- Narrow tinter — "tinter=narrow"
+
+ → Narrow tinter — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- 'Any hue' tinter — "tinter=anyhue"
+
+ → 'Any hue' tinter — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Vector tinter — "tinter=vector"
+
+ → Vector tinter — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
+
+
-
-
-
-Unalterable Stamps
+
+→ Unalterable Stamps ←
By default, a stamp can be flipped upside down, shown as a mirror image, or
both. This is done using the control buttons below the stamp selector, at
@@ -528,8 +528,8 @@ Unalterable Stamps
nomirror" to the stamp's data file.
-
-Initial Stamp Size
+
+→ Initial Stamp Size ←
By default, Tux Paint assumes that your stamp is sized appropriately for
unscaled display on a 608x472 canvas. This was the original Tux Paint
@@ -548,17 +548,17 @@ Initial Stamp Size
+ "scale 2.5"
+ "scale 2:5"
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".dat" extension at the end of the
filename.
+
-
-Pre-Mirrored and Flipped Stamps
+ ### Pre-Mirrored and Flipped Stamps ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@@ -598,7 +598,7 @@ When you use a 'starter' image, make modifications, and save it, the original
'starter' image is not overwritten. Additionally, as you edit your new picture,
the contents of the original 'starter' can affect it.
-Coloring-Book Style Starters
+ ### Coloring-Book Style Starters ###
The most basic kind of 'starter' is similar to a picture in a coloring book.
It's an outline of a shape which you can then color in and add details to. In
@@ -612,7 +612,7 @@ SVG. If saving as a PNG, you may optionally render the image as
black-and-transparent, rather than black-and-white, but (as of Tux Paint
0.9.21) this is not required.
-Scene-Style Starters
+ ### Scene-Style Starters ###
Along with the 'coloring-book' style overlay, you can also provide a separate
background image as part of a 'starter' picture. The overlay acts the same: it
@@ -651,7 +651,7 @@ allows it to continue to affect the drawing even after Tux Paint has been quit,
or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a 'starter' image, it will always be affected by it.)
-Starter Options
+ ### Starter Options ###
Aside from an image, starters can also be given other attributes. To do this,
you need to create a 'data file' for the starter. (Note: Tux Paint prior to
@@ -664,7 +664,7 @@ The file has the same name as the image, but a ".dat" extension. (e.g.,
"starter.png"'s data file is the text file "starter.dat", found in the same
directory.)
-allowscale
+→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@@ -703,8 +703,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
-
-background
+
+→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@@ -722,8 +722,8 @@ background
details.
-
-gravity
+
+→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@@ -747,6 +747,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
+
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@@ -754,6 +755,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
+
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@@ -761,12 +763,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
+
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
+
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@@ -774,13 +778,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
+
Focusing on the right of a starter image stretched to fit the height of the
canvas.
-
+
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@@ -822,7 +827,7 @@ quit, or another picture is loaded or a new image is created. (In other words,
if you base a drawing on a 'template' image, it will always be affected by it.)
-Template Options
+ ### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@@ -963,7 +968,7 @@ layouts).
We'll use the QWERTY keyboard as an example:
-Layout overview file ("qwerty.layout")
+ ### Layout overview file ("qwerty.layout") ###
This is a text file that specifies the other files used to describe the layout
and key mappings.
@@ -981,7 +986,7 @@ seen in the example above.
The "keyboardlist" line describes which layouts to switch to, when the user
clicks the left and right buttons on the keyboard. (See below.)
-Keyboard layout file ("qwerty.h_layout")
+ ### Keyboard layout file ("qwerty.h_layout") ###
This describes how big the keyboard is (as a "width × height" grid), and lists
each key with its numeric keycode (see the "keymap" file, below), the width it
@@ -1045,7 +1050,7 @@ described below.
* 1 — next layout (per the layout file's "keyboardlist" setting)
* 2 — previous layout (per the layout file's "keyboardlist" setting)
-Keymap file ("us-intl-altgr-dead-keys.keymap")
+ ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@@ -1085,7 +1090,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Composemap file ("en_US.UTF-8_Compose")
+ ### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the
@@ -1096,7 +1101,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
-Keysym definitions file ("keysymdef.h")
+ ### Keysym definitions file ("keysymdef.h") ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"
diff --git a/docs/en/FAQ.txt b/docs/en/FAQ.txt
index 085c22c90..024eb2015 100644
--- a/docs/en/FAQ.txt
+++ b/docs/en/FAQ.txt
@@ -21,15 +21,15 @@
+------------------------------+
-------------------------------------------------------------------------------
-Drawing-related
+ ### Drawing-related ###
-Fonts I added to Tux Paint only show squares
+→ Fonts I added to Tux Paint only show squares ←
The TrueType Font you're using might have the wrong encoding. If it's
'custom' encoded, for example, you can try running it through FontForge (
http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
(Email us if you need help with special fonts.)
-
-The Rubber Stamp tool is greyed out!
+
+→ The Rubber Stamp tool is greyed out! ←
This means that Tux Paint either couldn't find any stamp images, or was
asked not to load them.
@@ -55,8 +55,8 @@ The Rubber Stamp tool is greyed out!
configuration file.
-
-Stamp outlines are always rectangles
+
+→ Stamp outlines are always rectangles ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@@ -68,13 +68,13 @@ Stamp outlines are always rectangles
in the "tuxpaint.c" file in the "src" directory.
-
+
-------------------------------------------------------------------------------
-Interface Problems
+ ### Interface Problems ###
-Stamp thumbnails in the Stamp Selector look bad
+→ Stamp thumbnails in the Stamp Selector look bad ←
Tux Paint was probably compiled with the faster, lower quality thumbnail
code enabled. Run the command: "tuxpaint --verbose-version" from a command
@@ -89,24 +89,24 @@ Stamp thumbnails in the Stamp Selector look bad
in the "tuxpaint.c" file in the "src" directory.
-
-Pictures in the 'Open' dialog look bad
+
+→ Pictures in the 'Open' dialog look bad ←
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
Stamp Selector look bad", above.
-
-All of the text is in uppercase!
+
+→ All of the text is in uppercase! ←
The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override it with
"--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
yes" in a configuration file.
-
-Tux Paint is in a different language
+
+→ Tux Paint is in a different language ←
Make sure your locale setting is correct. See "Tux Paint won't switch to my
language", below.
-
-Tux Paint won't switch to my language
+
+→ Tux Paint won't switch to my language ←
+ Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your "/etc/
@@ -142,13 +142,13 @@ Tux Paint won't switch to my language
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Printing
+ ### Printing ###
-Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
+→ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) ←
Tux Paint prints by creating a PostScript rendition of the picture and
sending it to an external command. By default, this command is the "lpr"
@@ -167,8 +167,8 @@ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
you will need to go back and alter it to accept PostScript.
-
-I get the message "You can't print yet!" when I go to print
+
+→ I get the message "You can't print yet!" when I go to print ←
The "print delay" option is on. You can only print once every X seconds.
@@ -190,8 +190,8 @@ I get the message "You can't print yet!" when I go to print
allow unlimited printing. (You won't have to wait between prints.)
-
-I simply can't print! The button is greyed out!
+
+→ I simply can't print! The button is greyed out! ←
The "no print" option is on.
@@ -212,41 +212,41 @@ I simply can't print! The button is greyed out!
is checked.
-
+
-------------------------------------------------------------------------------
-Saving
+ ### Saving ###
-Where does Tux Paint save my drawings?
+→ Where does Tux Paint save my drawings? ←
Unless you asked Tux Paint to save into a specific location (using the
"savedir" option), Tux Paint saves into a standard location on your local
drive:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
The images are stored as PNG bitmaps, which most modern programs should be
able to load (image editors, word processors, web browsers, etc.)
-
-Tux Paint always saves over my old picture
+
+→ Tux Paint always saves over my old picture ←
The "save over" option is enabled. (This disables the prompt that would
appear when you click 'Save.')
@@ -271,8 +271,8 @@ Tux Paint always saves over my old picture
Also, see "Tux Paint always saves a new picture!", below.
-
-Tux Paint always saves a new picture!
+
+→ Tux Paint always saves a new picture! ←
The "never save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@@ -297,13 +297,13 @@ Tux Paint always saves a new picture!
Also, see "Tux Paint always saves over my old picture!", above.
-
+
-------------------------------------------------------------------------------
-Audio Problems
+ ### Audio Problems ###
-There's no sound!
+→ There's no sound! ←
+ First, check the obvious:
o Are your speakers connected and turned on?
o Is the volume turned up on your speakers?
@@ -363,8 +363,8 @@ There's no sound!
headers are available!
-
-Tux Paint makes too much noise! Can I turn them off?
+
+→ Tux Paint makes too much noise! Can I turn them off? ←
Yes, there are a number of ways to disable sounds in Tux Paint:
@@ -380,9 +380,9 @@ Tux Paint makes too much noise! Can I turn them off?
o Alternatively, recompile Tux Paint with sound support disabled.
(See above, and the 'Install' documentation.
-
-The stereo panning of sound effects is bothersome; can sound effects be
- monophonic?
+
+→ The stereo panning of sound effects is bothersome; can sound effects be
+ monophonic? ←
Run Tux Paint with the "no stereo" option:
@@ -393,8 +393,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
"Video & Sound") is not checked.
-
-The sound effects sound strange
+
+→ The sound effects sound strange ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@@ -404,16 +404,17 @@ The sound effects sound strange
"tuxpaint --version" to verify), and so on.)
-
+
-------------------------------------------------------------------------------
-Fullscreen Mode Problems
+ ### Fullscreen Mode Problems ###
-When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
+→ When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns
+ black! ←
This is apparently a bug in the SDL library. Sorry.
-
-When I run Tux Paint full-screen, it has large borders around it
+
+→ When I run Tux Paint full-screen, it has large borders around it ←
Linux users - Your X-Window server is probably not set with the ability to
switch to the desired resolution: 800×600. (or whatever resolution you have
@@ -440,8 +441,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
-
-Tux Paint keeps running in Full Screen mode - I want it windowed!
+
+→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
The "fullscreen" option is set.
@@ -464,20 +465,21 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
is not checked.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-
+
-------------------------------------------------------------------------------
-Other Problems
+ ### Other Problems ###
-Tux Paint won't run
+→ Tux Paint won't run ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -503,8 +505,8 @@ Tux Paint won't run
command-line, or "nolockfile=yes" to the configuration file.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -526,8 +528,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-I can't quit Tux Paint
+
+→ I can't quit Tux Paint ←
The "no quit" option is set. This disables the "Quit" button in Tux Paint's
toolbar (greying it out), and prevents Tux Paint from being exited via the
@@ -543,8 +545,8 @@ I can't quit Tux Paint
combination on your keyboard to quit Tux Paint.)
-
-I don't want "no quit" mode enabled!
+
+→ I don't want "no quit" mode enabled! ←
If you're running Tux Paint from a command-line, make sure you're not
giving it a "--noquit" option.
@@ -563,8 +565,8 @@ I don't want "no quit" mode enabled!
Key" (under "Simplification") is not checked.
-
-Tux Paint keeps writing weird messages to the screen / to a text file
+
+→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@@ -578,8 +580,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
in the "tuxpaint.c" file in the "src" directory.
-
-Tux Paint is using options I didn't specify!
+
+→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@@ -656,11 +658,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Help / Contact
+ ### Help / Contact ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:
diff --git a/docs/en/INSTALL.txt b/docs/en/INSTALL.txt
index 5f2847884..b368e55c4 100644
--- a/docs/en/INSTALL.txt
+++ b/docs/en/INSTALL.txt
@@ -28,7 +28,7 @@
Requirements
-Simple DirectMedia Layer library (libSDL)
+ ### Simple DirectMedia Layer library (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Other Libraries
+## Other Libraries ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
-libPNG
+→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Linux/Unix only)
+
+→ libpaper (Linux/Unix only) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@@ -92,8 +92,8 @@ libpaper (Linux/Unix only)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
-
-SVG graphics support
+
+→ SVG graphics support ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
- librsvg-2 & libCairo2 (newer libraries)
+ → librsvg-2 & libCairo2 (newer libraries) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o These also depend on the following:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Older SVG libraries
+
+ → Older SVG libraries ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o These also depend on the following:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Animated GIF Export feature
+
+→ Animated GIF Export feature ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@@ -133,8 +133,8 @@ Animated GIF Export feature
https://github.com/ImageOptim/libimagequant
-
-NetPBM Tools (optional) No longer used, by default
+
+→ NetPBM Tools (optional) No longer used, by default ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@@ -144,7 +144,7 @@ NetPBM Tools (optional) No longer used, by default
http://netpbm.sourceforge.net/
-
+
Compiling and Installation
@@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
July 10, 2022 Shin-ichi TOYAMA
-Compiling Set-Up
+## Compiling Set-Up ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@@ -207,7 +207,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@@ -264,7 +264,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -365,7 +365,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -393,7 +393,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Building the Tux Paint Windows Installer
+## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Running the Tux Paint Windows Installer
+## Running the Tux Paint Windows Installer ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
-Changing the Settings Using the Shortcut
+## Changing the Settings Using the Shortcut ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@@ -460,7 +460,7 @@ pushed the "Apply" button!).
When you have finished, click "OK."
-If Something Goes Wrong
+## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -474,9 +474,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compiling:
+## Compiling: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -487,7 +487,8 @@ shell prompt (e.g., "$"):
$ make
-Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+## Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@@ -495,7 +496,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
-Disabling Sound at Compile-time
+## Disabling Sound at Compile-time ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@@ -503,12 +504,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
-Other options
+## Other options ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
-If you get errors
+## If you get errors ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@@ -516,7 +517,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
-Installng
+## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@@ -542,7 +543,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Changing Where Things Go
+# Changing Where Things Go #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@@ -551,48 +552,48 @@ default, set to "/usr/local".
Other variables are:
-BIN_PREFIX
+→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
June 5, 2022 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Prerequisites
+## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -628,7 +629,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -640,7 +641,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -654,7 +655,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-How to Build
+## How to Build ##
Simply, run:
@@ -668,7 +669,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Known Issues
+## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -685,7 +686,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Old Versions of macOS
+## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -725,7 +726,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Recompiling MacPorts
+## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -749,7 +750,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Building a Universal Binary
+## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -763,7 +764,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
March 29, 2023 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -772,7 +773,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Prerequisites
+## Prerequisites ##
You will need recent versions of:
@@ -797,7 +798,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Building
+## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -826,36 +827,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
May 7, 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Prerequisites
+## Prerequisites ##
Install the required develop packages in Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Building
+## Building ##
make PREFIX=/boot/home/config/non-packaged
-Tux Paint Stamps
+## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -868,9 +870,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
-Windows
+ ### Windows ###
-Using the Uninstaller
+## Using the Uninstaller ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@@ -879,19 +881,19 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
When it has finished, click on the close button.
-Using the Control Panel
+## Using the Control Panel ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
"/Library/Application Support/TuxPaint/" (all users) and
"/Users/username/Library/Application Support/TuxPaint/" (individual users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/en/MAGIC-API.txt b/docs/en/MAGIC-API.txt
index 526a8d2f2..b8350b98d 100644
--- a/docs/en/MAGIC-API.txt
+++ b/docs/en/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/en/OPTIONS.txt b/docs/en/OPTIONS.txt
index d10bd7519..d7c07f0b6 100644
--- a/docs/en/OPTIONS.txt
+++ b/docs/en/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Options Documentation
+ ### Options Documentation ###
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -45,11 +45,11 @@ each time you start it up.
The file is simply a plain text file containing the options you want enabled:
-Linux and Unix Users
+ ### Linux and Unix Users ###
/home/username/.tuxpaintrc
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -57,11 +57,11 @@ at:
/etc/tuxpaint/tuxpaint.conf
-macOS Users
+ ### macOS Users ###
/Users/username/Library/Application Support/TuxPaint/tuxpaint.cfg
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -69,14 +69,14 @@ at:
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Windows Users
+ ### Windows Users ###
C:\Users\username\AppData\Roaming\TuxPaint\tuxpaint.cfg
You can use NotePad or WordPad to create this file. Be sure to save it as Plain
Text, and make sure the filename doesn't have ".txt" at the end...
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -84,7 +84,7 @@ at:
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -97,11 +97,11 @@ Available Options
The following settings can be set in the configuration file. (Command-line
settings will override these. See the "Command-Line Options" section, below.)
-Video/Sound
+ ### Video/Sound ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Run the program in full screen mode, rather than in a window.
@@ -110,15 +110,15 @@ fullscreen=yes
overridden by the command-line option "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Run the program in full screen mode. Additionally, assume the screen's
current resolution (set by the operating system).
-
-windowsize=SIZE
+
+→ windowsize=SIZE ←
Run the program at a different size (in windowed mode) or at a different
screen resolution (in fullscreen mode), rather than the default (usually
@@ -140,8 +140,8 @@ windowsize=SIZE
of the display, Tux Paint will fall back to the display's dimensions.
-
-orient=portrait
+
+→ orient=portrait ←
Swaps the width/height options given to Tux Paint, useful for rotating the
window on portait displays, such as a tablet PC that's in tablet
@@ -152,16 +152,16 @@ orient=portrait
be overridden by the command-line option "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
When running Tux Paint in fullscreen mode, this assumes the screen's
current resolution (overriding any "windowsize" option), as set by the
operating system.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -174,11 +174,11 @@ allowscreensaver=yes
command-line option "--disablescreensaver".
+
+## Sound ##
-Sound
-
-nosound=yes
+→ nosound=yes ←
Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to
reenable sounds if they were disabled using this option.)
@@ -188,8 +188,8 @@ nosound=yes
cases, may be overridden by the command-line option "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Disable stereo panning support. (Useful for users with hearing impairment
in one ear, or places where a single speaker or headphone is being used.)
@@ -199,11 +199,11 @@ nostereo=yes
cases, may be overridden by the command-line option "--stereo".
+
+## Interface Size ##
-Interface Size
-
-buttonsize=SIZE
+→ buttonsize=SIZE ←
Set the pixel size of buttons in Tux Paint's user interface (overriding the
default of "48"). Useful when using very high-density displays or coarse
@@ -224,8 +224,8 @@ buttonsize=SIZE
stderr.)
-
-colorsrows=ROWS
+
+→ colorsrows=ROWS ←
How many rows of color palette buttons to show; useful when using a large
color palette (see "colorfile", above), and/or for use with coarse input
@@ -233,13 +233,13 @@ colorsrows=ROWS
and "3".
+
+ ### Mouse/Keyboard ###
-Mouse/Keyboard
+## Cursor ##
-Cursor
-
-nofancycursors=yes
+→ nofancycursors=yes ←
This disables the fancy mouse pointer shapes in Tux Paint, and uses your
environment's normal mouse pointer.
@@ -253,8 +253,8 @@ nofancycursors=yes
"--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
This completely hides the mouse pointer shapes in Tux Paint.
@@ -265,11 +265,11 @@ hidecursor=yes
both cases, may be overridden by the command-line option "--showcursor".
+
+## Keyboard ##
-Keyboard
-
-noshortcuts=yes
+→ noshortcuts=yes ←
This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for
a new image, etc.)
@@ -282,11 +282,11 @@ noshortcuts=yes
both cases, may be overridden by the command-line option "--shortcuts".
+
+## Mouse ##
-Mouse
-
-grab=yes
+→ grab=yes ←
Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse
is confined to Tux Paint's window, and nearly all keyboard input is passed
@@ -301,8 +301,8 @@ grab=yes
cases, may be overridden by the command-line option "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
This disables support for the wheel on mice that have it. (Normally, the
wheel will scroll the selector menu on the right.)
@@ -312,8 +312,8 @@ nowheelmouse=yes
In both cases, may be overridden by the command-line option "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could
also be used for clicking. In version 0.9.15, it was changed so that only
@@ -330,13 +330,13 @@ nobuttondistinction=yes
command-line option "--buttondistinction".
+
+ ### Simplification ###
-Simplification
+## Interface Simplification ##
-Interface Simplification
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Disable the rotation step of the 'Shape' tool. Click, drag and release is
all that will be needed to draw a shape.
@@ -347,8 +347,8 @@ simpleshapes=yes
"--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
In this mode, much simpler outlines and 'rubber-band' lines are displayed
when using the Lines, Shapes, Stamps and Eraser tools.
@@ -361,8 +361,8 @@ nooutlines=yes
both cases, may be overridden by the command-line option "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
All text will be rendered only in uppercase (e.g., "Brush" will be
"BRUSH"). Useful for children who can read, but who have only learned
@@ -373,11 +373,11 @@ uppercase=yes
both cases, may be overridden by the command-line option "--mixedcase".
+
+## Initial Stamp Size ##
-Initial Stamp Size
-
-stampsize=SIZE
+→ stampsize=SIZE ←
Use this option to force Tux Paint to set the starting size of all stamps.
The SIZE value should be between 0 (smallest) and 10 (largest). The size is
@@ -387,11 +387,11 @@ stampsize=SIZE
Specify "default" to let Tux Paint decide (its standard behavior).
+
+## Control Simplification ##
-Control Simplification
-
-noquit=yes
+→ noquit=yes ←
Disable the on-screen "Quit" button and prevent the [Escape] key from
quitting Tux Paint.
@@ -408,8 +408,8 @@ noquit=yes
cases, may be overridden by the command-line option "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
This option tells Tux Paint to not load any rubber stamp images, which in
turn ends up disabling the Stamps tool.
@@ -422,8 +422,8 @@ nostamps=yes
cases, may be overridden by the command-line option "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Some images in the Stamps tool can be mirrored, flipped, and/or have their
size changed. This option disables the controls, and only provides the
@@ -435,8 +435,8 @@ nostampcontrols=yes
"--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
This disables the rotation step of the Stamps tool, immediately placing the
stamp in its regular orientation (with any flipping or mirroring applied)
@@ -451,8 +451,8 @@ nostamprotation=yes
"--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Some Magic tools have the option of acting like a paintbrush, or affecting
the entire canvas at once. This option disables the controls, and only
@@ -464,8 +464,8 @@ nomagiccontrols=yes
"--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Some Magic tools offer various size settings. This option disables the
sizing control, and only provides the tools' default sizes. (Some plugins
@@ -477,8 +477,8 @@ nomagicsizes=yes
In both cases, may be overridden by the command-line option "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -494,8 +494,8 @@ ungroupmagictools=yes
option "--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Disable the control buttons shown when using the Shapes tool that allow
changing how shapes are drawn — centered around the initial mouse click, or
@@ -507,8 +507,8 @@ noshapecontrols=yes
"--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Disables the Label tool: the tool that allows text entry which can be
edited later.
@@ -518,8 +518,8 @@ nolabel=yes
cases, may be overridden by the command-line option "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Disables the brush spacing option of the Paint and Lines tools. The
brushes' default spacings will be used.
@@ -533,8 +533,8 @@ nobrushspacing=yes
"--brushspacing".
-
-complexity=COMPLEXITY
+
+→ complexity=COMPLEXITY ←
Sets the complexity (expertise) level of Tux Paint, which can either
disable some Magic tools, or cause them to operate differently. (For
@@ -544,18 +544,18 @@ complexity=COMPLEXITY
The COMPLEXITY value may be one of:
- advanced (the default)
+ → advanced (the default) ←
"Advanced" — For users familiar with Tux Paint and who can operate more
complex tools.
-
- beginner
+
+ → beginner ←
"Beginner" — For users comfortable with Tux Paint, but where complex
tools may cause confusion or frustration.
-
- novice
+
+ → novice ←
"Novice" — For first-time Tux Paint users, users inexperienced with
computers, or those with special accessibility needs.
-
+
📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
Consult the individual Magic tools' documentation.
@@ -565,8 +565,8 @@ complexity=COMPLEXITY
may be overridden by the command-line option "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Disables the ability to create a new Template image (based on a saved
drawing) from within the Open dialog.
@@ -580,8 +580,8 @@ notemplateexport=yes
option "--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Disables the ability to erase saved drawings via the "Erase" button on the
Open dialog, or exported Template images (based on a saved drawing) via the
@@ -595,13 +595,13 @@ noerase=yes
cases, may be overridden by the command-line option "--erase".
+
+ ### Languages ###
-Languages
+## Language ##
-Language
-
-lang=LANGUAGE
+→ lang=LANGUAGE ←
Run Tux Paint in one of the supported languages. Possible choices for
LANGUAGE currently include:
@@ -863,8 +863,8 @@ lang=LANGUAGE
+-----------------------------------------------------------------+
-
---locale LOCALE
+
+→ --locale LOCALE ←
Run Tux Paint in one of the support languages. See the "Choosing a
Different Language" section below for the locale strings (e.g., "de_DE" for
@@ -875,8 +875,8 @@ lang=LANGUAGE
setting, if possible.)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
For stamps that can be mirrored, this option sets them to their mirrored
shape by default.
@@ -890,11 +890,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Fonts ##
-Fonts
-
-sysfonts=yes
+→ sysfonts=yes ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -905,8 +905,8 @@ sysfonts=yes
both cases, may be overridden by the command-line option "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts
directory, including locale-specific ones (e.g., the one for Tibetan, which
@@ -922,8 +922,8 @@ alllocalefonts=yes
command-line option "--currentlocalefont".
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -933,19 +933,19 @@ uifont=FONT NAME
standard behavior).
+
+ ### Printing ###
-Printing
+## Print Permissions ##
-Print Permissions
-
-noprint=yes
+→ noprint=yes ←
Disable the printing feature.
-
-printdelay=SECONDS
+
+→ printdelay=SECONDS ←
Restrict printing so that printing can occur only once every SECONDS
seconds.
@@ -955,11 +955,11 @@ printdelay=SECONDS
overridden by the command-line option "--printdelay=0".
+
+## Show Printer Dialog ##
-Show Printer Dialog
-
-altprint=always
+→ altprint=always ←
This causes Tux Paint to always show the printer dialog (or, on Linux/Unix,
run the "altprintcommand") when the 'Print' button is clicked. In other
@@ -967,8 +967,8 @@ altprint=always
need to hold [Alt] every time.
-
-altprint=never
+
+→ altprint=never ←
This prevents Tux Paint from ever showing the printer dialog (or, on Linux/
Unix, run the "altprintcommand") when the 'Print' button is clicked. In
@@ -976,8 +976,8 @@ altprint=never
'Print' button.
-
-altprint=mod
+
+→ altprint=mod ←
This is the normal, default behavior. Tux Paint shows a printer dialog (or,
on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed
@@ -985,11 +985,11 @@ altprint=mod
prints without showing a dialog.
+
+## Save Printer Configuration ##
-Save Printer Configuration
-
- printcfg=yes
+ → printcfg=yes ←
(Windows and macOS only)
@@ -1009,11 +1009,11 @@ Save Printer Configuration
"--noprintcfg".
+
+ ## Print Commands ##
- Print Commands
-
- printcommand=COMMAND
+ → printcommand=COMMAND ←
(Linux and Unix only)
@@ -1030,8 +1030,8 @@ Save Printer Configuration
to version 0.9.15, you will need to change it.
-
- altprintcommand=COMMAND
+
+ → altprintcommand=COMMAND ←
(Linux and Unix only)
@@ -1046,11 +1046,11 @@ Save Printer Configuration
kprinter
+
+ ## Paper Size ##
- Paper Size
-
- papersize=PAPERSIZE
+ → papersize=PAPERSIZE ←
(Platforms that use Tux Paint's internal PostScript generator — not
Windows, macOS, BeOS, or Haiku.)
@@ -1067,40 +1067,40 @@ Save Printer Configuration
esheet.
+
+ ### Saving ###
- Saving
+ ## Save Over Earlier Work ##
- Save Over Earlier Work
-
- saveover=yes
+ → saveover=yes ←
This disables the "Save over the old version...?" prompt when saving an
existing file. With this option, the older version will always be
replaced by the new version, automatically.
-
- saveover=new
+
+ → saveover=new ←
This also disables the "Save over the old version...?" prompt when
saving an existing file. This option, however, will always save a new
file, rather than overwrite the older version.
-
- saveover=ask
+
+ → saveover=ask ←
(This option is redundant, since this is the default.) When saving an
existing drawing, you will be first asked whether to save over the
older version or not.
+
+ ## Starting Out ##
- Starting Out
-
- startblank=yes
+ → startblank=yes ←
This causes Tux Paint to display a blank canvas when it first starts
up, rather than loading the last image that was being edited.
@@ -1111,8 +1111,8 @@ Save Printer Configuration
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Places the blank color options in the New dialog at the end, so that
any Starters and/or Templates are shown first.
@@ -1123,30 +1123,30 @@ Save Printer Configuration
command-line option "--newcolorsfirst".
+
+ ## Save and Export Directories ##
- Save and Export Directories
-
- savedir=DIRECTORY
+ → savedir=DIRECTORY ←
Use this option to change where Tux Paint's "saved" directory/folder is
located, which is where Tux Paint saves and opens pictures.
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/username/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/username/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.
@@ -1159,8 +1159,8 @@ Save Printer Configuration
Example: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORY
+
+ → exportdir=DIRECTORY ←
Use this option to change where Tux Paint exports files — single
images, or animated GIF slideshows — for external use.
@@ -1199,11 +1199,11 @@ Save Printer Configuration
Example: exportdir=/home/penguin/TuxPaintExports
+
+ ## More Saving Options ##
- More Saving Options
-
- nosave=yes
+ → nosave=yes ←
This disables Tux Paint's ability to save files (and therefore disables
the on-screen "Save" button). It can be used in situations where the
@@ -1214,8 +1214,8 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--save".
-
- autosave=yes
+
+ → autosave=yes ←
This prevents Tux Paint from asking whether you want to save the
current picture when quitting, and assumes you do.
@@ -1226,8 +1226,8 @@ Save Printer Configuration
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
This reverses the sorting of the Open and Slideshow dialogs, placing
the newest images at the top of the list.
@@ -1238,13 +1238,13 @@ Save Printer Configuration
command-line option "--noreversesort".
+
+ ### Data ###
- Data
+ ## Lockfile ##
- Lockfile
-
- nolockfile=yes
+ → nolockfile=yes ←
By default, Tux Paint uses what's known as a 'lockfile' to prevent it
from being launched more than once in 30 seconds. (This is to avoid
@@ -1266,11 +1266,11 @@ Save Printer Configuration
"--lockfile".
+
+ ## Data Directory ##
- Data Directory
-
- datadir=DIRECTORY
+ → datadir=DIRECTORY ←
Use this option to change where Tux Paint looks for personal data files
(brushes, stamps, starters, templates, and fonts specific to the
@@ -1282,15 +1282,15 @@ Save Printer Configuration
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
/home/username/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/username/Library/Application Support/TuxPaint/
-
+
📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting
or default as for "savedir" to search for data files. As of version
@@ -1302,11 +1302,11 @@ Save Printer Configuration
Example: datadir=/home/johnny/tuxpaint-data/
+
+ ## Color Palette File ##
- Color Palette File
-
- colorfile=FILENAME
+ → colorfile=FILENAME ←
You may override Tux Paint's default color palette by creating a plain
ASCII text file that describes the colors you want, and pointing to
@@ -1333,23 +1333,23 @@ Save Printer Configuration
byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".
+
+ ### Accessibility ###
- Accessibility
+ ## Mouse ##
- Mouse
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
In this mode, instead of clicking, dragging and releasing (e.g., to
draw), you click, move, and click again to end the motion.
+
+ ## Keyboard ##
- Keyboard
-
- keyboard=yes
+ → keyboard=yes ←
This allows the keyboard arrow keys to be used to control the mouse
pointer. (e.g., for mouseless environments, or handicapped/
@@ -1388,18 +1388,18 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--mouse".
+
+ ## Onscreen Keyboard ##
- Onscreen Keyboard
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Presents a clickable on-screen keyboard when using the Text and Label
tools.
-
- onscreen-keyboard-layout=LAYOUTNAME
+
+ → onscreen-keyboard-layout=LAYOUTNAME ←
Selects the initial layout for the on-screen keyboard when using the
Text and Label tools.
@@ -1407,8 +1407,8 @@ Save Printer Configuration
setting both is redundant.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Disables the possibility for changing the layout of the on-screen
keyboard when using the Text and Label tools, useful for simplifying
@@ -1422,191 +1422,191 @@ Save Printer Configuration
by the command-line option "--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Main Device ##
- Main Device
-
- joystick-dev=N
+ → joystick-dev=N ←
Specify which joystick device should be used by Tux Paint. Default
value is 0 (the first joystick).
-
- joystick-slowness=SPEED
+
+ → joystick-slowness=SPEED ←
Sets a delay at each axis motion, allowing to slow the joystick.
Allowed values are from 0 to 500. Default value is 15.
-
- joystick-threshold=THRESHOLD
+
+ → joystick-threshold=THRESHOLD ←
Sets the minimum level of axis motion to start moving the pointer.
Allowed values are from 0 to 32766. Default value is 3200.
-
- joystick-maxsteps=STEPS
+
+ → joystick-maxsteps=STEPS ←
Sets the maximum pixels the pointer will move at once. Allowed values
are from 1 to 7. Default value is 7.
+
+ ## Hat ##
- Hat
-
- joystick-hat-slowness=SPEED
+ → joystick-hat-slowness=SPEED ←
Sets a delay at each automatic motion, allowing to slow the speed of
the hat. Allowed values are from 0 to 500. Default value is 15.
-
- joystick-hat-timeout=MILLISECONDS
+
+ → joystick-hat-timeout=MILLISECONDS ←
Sets the delay after wich the pointer will start moving automatically
if the hat is keeped pushed. Allowed values are from 0 to 3000. Default
value is 1000.
+
+ ## Buttons to Disable ##
- Buttons to Disable
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
A set of joystick button numbers, as seen by SDL, that should be
ignored. Otherwise, unless they are used by one of the "joystick-btn-"
options above, buttons will be seen as a mouse left-click.
+
+## Button Shortcuts ##
-Button Shortcuts
-
- joystick-btn-escape=BUTTON NUMBER
+ → joystick-btn-escape=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be used
to generate a escape event. Useful to dismiss dialogs and quit.
-
- joystick-btn-brush=BUTTON NUMBER
+
+ → joystick-btn-brush=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the brush tool.
-
- joystick-btn-stamp=BUTTON NUMBER
+
+ → joystick-btn-stamp=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the stamp tool.
-
- joystick-btn-lines=BUTTON NUMBER
+
+ → joystick-btn-lines=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the lines tool.
-
- joystick-btn-shapes=BUTTON NUMBER
+
+ → joystick-btn-shapes=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the shapes tool.
-
- joystick-btn-text=BUTTON NUMBER
+
+ → joystick-btn-text=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the text tool.
-
- joystick-btn-label=BUTTON NUMBER
+
+ → joystick-btn-label=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the label tool.
-
- joystick-btn-fill=BUTTON NUMBER
+
+ → joystick-btn-fill=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the fill tool.
-
- joystick-btn-magic=BUTTON NUMBER
+
+ → joystick-btn-magic=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the magic tool.
-
- joystick-btn-undo=BUTTON NUMBER
+
+ → joystick-btn-undo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to invoke the undo tool.
-
- joystick-btn-redo=BUTTON NUMBER
+
+ → joystick-btn-redo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select redo tool.
-
- joystick-btn-eraser=BUTTON NUMBER
+
+ → joystick-btn-eraser=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select eraser tool.
-
- joystick-btn-new=BUTTON NUMBER
+
+ → joystick-btn-new=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for creating a new drawing.
-
- joystick-btn-open=BUTTON NUMBER
+
+ → joystick-btn-open=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for opening an existing drawing.
-
- joystick-btn-save=BUTTON NUMBER
+
+ → joystick-btn-save=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to save the drawing.
-
- joystick-btn-pgsetup=BUTTON NUMBER
+
+ → joystick-btn-pgsetup=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the page setup dialog for printing.
-
- joystick-btn-print=BUTTON NUMBER
+
+ → joystick-btn-print=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to print.
-
+
Overriding System Config. Options
@@ -1631,7 +1631,7 @@ Button Shortcuts
Options may also be issued on the command-line when you go to launch Tux
Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--WIDTHxHEIGHT
--orient=portrait
@@ -1713,13 +1713,14 @@ Button Shortcuts
--reversesort
--lang LANGUAGE
--colorfile FILE
+ ←
These enable or correspond to the configuration file options described
above.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1760,14 +1761,15 @@ Button Shortcuts
--save
--noautosave
--noreversesort
+ ←
These options can be used to override any settings made in the
configuration file. (If the option isn't set in the configuration file
(s), no overriding option is necessary.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1776,52 +1778,52 @@ Button Shortcuts
Linux) — if it exists — will be used.
+
-
- Command-Line Informational Options
+ ### Command-Line Informational Options ###
The following options display some informative text on the screen. Tux
Paint doesn't actually start up and run afterwards, however.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Show brief license information about copying Tux Paint.
-
- --usage
+
+ → --usage ←
Display the list of available command-line options.
-
- --help
+
+ → --help ←
Display brief help on using Tux Paint.
-
- --lang help
+
+ → --lang help ←
Display a list of available languages in Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Display list of attached joysticks available to Tux Paint.
-
+
Choosing a Different Language
@@ -1835,7 +1837,7 @@ Button Shortcuts
Use the option "--lang help" to list the language options available.
- Available Languages
+ ### Available Languages ###
+-------------------------------------------------------------------------+
| | Language | Language | Input Method |
@@ -2136,7 +2138,7 @@ Button Shortcuts
can be used to cycle through the supported input methods while the Text
tool is active.
- Setting Your Environment's Locale
+ ### Setting Your Environment's Locale ###
Changing your locale will affect much of your environment.
@@ -2147,7 +2149,7 @@ Button Shortcuts
If you haven't already set your environment's locale, the following will
briefly explain how:
- Linux/Unix Users
+ ## Linux/Unix Users ##
First, be sure the locale you want to use is enabled by editing the file "/
etc/locale.gen" on your system and then running the program "locale-gen" as
@@ -2175,7 +2177,7 @@ Button Shortcuts
setenv LANG es_ES ; \
tuxpaint
- Windows Users
+ ## Windows Users ##
Tux Paint will recognize the current locale and use the appropriate files
by default. So this section is only for people trying different languages.
@@ -2200,7 +2202,7 @@ Button Shortcuts
+ Edit the value of the parameter "LANG" (create it, if it doesn't
exists).
- Special Fonts
+ ### Special Fonts ###
Some languages require special fonts be installed. These font files (which
are in TrueType format (TTF)), are much too large to include with the Tux
diff --git a/docs/en/PNG.txt b/docs/en/PNG.txt
index 968605898..2f1a7887c 100644
--- a/docs/en/PNG.txt
+++ b/docs/en/PNG.txt
@@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
-How To Make PNGs
+ ### How To Make PNGs ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
-GIMP & Krita
+→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
+
+→ Command-line Tools ←
-Command-line Tools
-
- NetPBM
+ → NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@@ -58,8 +58,8 @@ Command-line Tools
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@@ -68,11 +68,11 @@ Command-line Tools
or to learn more, visit https://jpegclub.org/.
+
-
-
-Proprietary Software for Windows
+
+→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -80,13 +80,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Macintosh Users
+
+→ Macintosh Users ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/en/README.txt b/docs/en/README.txt
index f4085d131..672c11143 100644
--- a/docs/en/README.txt
+++ b/docs/en/README.txt
@@ -1,12 +1,12 @@
Tux Paint
version 0.9.34
- A simple drawing program for children
+ ## A simple drawing program for children ##
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
- October 12, 2024
+ October 14, 2024
+-------------------------------------------------+
| Table of Contents |
@@ -44,7 +44,7 @@
I. About Tux Paint
-A. What Is "Tux Paint"?
+ ### A. What Is "Tux Paint"? ###
Tux Paint is a free drawing program designed for young children (kids ages 3
and up). It has a simple, easy-to-use interface, fun sound effects, and an
@@ -52,43 +52,43 @@ encouraging cartoon mascot who helps guide children as they use the program. It
provides a blank canvas and a variety of drawing tools to help your child be
creative.
-B. Objectives
+ ### B. Objectives ###
-Easy and Fun
+→ Easy and Fun ←
Tux Paint is meant to be a simple drawing program for young children. It is
not meant as a general-purpose drawing tool. It is meant to be fun and easy
to use. Sound effects and a cartoon character help let the user know what's
going on, and keeps them entertained. There are also extra-large
cartoon-style mouse pointer shapes.
-
-Extensibility
+
+→ Extensibility ←
Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped
in and pulled out. For example, a teacher can drop in a collection of
animal shapes and ask their students to draw an ecosystem. Each shape can
have a sound which is played, and textual facts which are displayed, when
the child selects the shape.
-
-Portability
+
+→ Portability ←
Tux Paint is portable among various computer platforms: Windows, Macintosh,
Linux, etc. The interface looks the same among them all. Tux Paint runs
suitably well on older systems, and can be built to run better on slow
systems.
-
-Simplicity
+
+→ Simplicity ←
There is no direct access to the computer's underlying intricacies. The
current image is kept when the program quits, and reappears when it is
restarted. Saving images requires no need to create filenames or use the
keyboard. Opening an image is done by selecting it from a collection of
thumbnails. Access to other files on the computer is restricted.
-
-Accessibility
+
+→ Accessibility ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
+
-
-C. License
+ ### C. License ###
Tux Paint is an Open Source project, Free Software released under the GNU
General Public License (GPL). It is free, and the 'source code' behind the
@@ -97,62 +97,76 @@ parts of the program in their own GPL'd software.)
See COPYING.txt for the full text of the GPL license.
-D. What's New in Tux Paint version 0.9.34?
+ ### D. What's New in Tux Paint version 0.9.34? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
See CHANGES.txt for the complete list of changes.
II. Using Tux Paint
-A. Launching Tux Paint
+ ### A. Launching Tux Paint ###
-1. Linux/Unix Users
+## 1. Linux/Unix Users ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@@ -163,7 +177,7 @@ Alternatively, you can run the following command at a shell prompt (e.g., "$"):
If any errors occur, they will be displayed on the terminal (to STDERR).
-2. Windows Users
+## 2. Windows Users ##
[Tux Paint Icon]
Tux Paint
@@ -187,13 +201,14 @@ installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
-3. macOS Users
+## 3. macOS Users ##
Simply double-click the "Tux Paint" icon.
[Title screen]
+
-B. Title Screen
+ ### B. Title Screen ###
When Tux Paint first loads, a title/credits screen will appear.
@@ -201,20 +216,22 @@ Once loading is complete, press a key or click or tap in the Tux Paint window
to continue. (Or, after about 5 seconds, the title screen will go away
automatically.)
-C. Main Screen
+ ### C. Main Screen ###
The main screen is divided into the following sections:
[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser,
New, Open, Save, Print, Quit]
-Left Side: Toolbar
+
+→ Left Side: Toolbar ←
The toolbar contains the drawing and editing controls.
-
+
[Canvas]
-Middle: Drawing Canvas
+
+→ Middle: Drawing Canvas ←
The largest part of the screen, in the center, is the drawing canvas. This
is, obviously, where you draw!
@@ -225,9 +242,10 @@ Middle: Drawing Canvas
more details.
-
+
[Selectors - Brushes, Letters, Shapes, Stamps]
-Right Side: Selector
+
+→ Right Side: Selector ←
Depending on the current tool, the selector shows different things. e.g.,
when the Paint Brush or Line tool is selected, it shows the various brushes
@@ -236,10 +254,11 @@ Right Side: Selector
various fonts.
-
+
[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue,
Purple, Brown, Grey]
-Lower: Colors
+
+→ Lower: Colors ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@@ -295,23 +314,24 @@ Lower: Colors
documentation.
-
+
(Example tip: 'Pick a shape. Click to pick the center, drag, then let go
when it is the size you want. Move around to rotate it, and click to draw
it.')
-Bottom: Help Area
+
+→ Bottom: Help Area ←
At the very bottom of the screen, Tux, the Linux Penguin, provides tips and
other information while you use Tux Paint.
+
+ ### D. Available Tools ###
-D. Available Tools
+## 1. Drawing Tools ##
-1. Drawing Tools
-
-a. "Paint" Tool (Brush)
+a. "Paint" Tool (Brush) ←
The Paint Brush tool lets you draw freehand, using various brushes (chosen
in the Selector on the right) and colors (chosen in the Color palette
@@ -353,8 +373,8 @@ a. "Paint" Tool (Brush)
the brush spacing controls. See the "Options" documentation.
-
-b."Stamp" Tool (Rubber Stamps)
+
+b."Stamp" Tool (Rubber Stamps) ←
The Stamp tool is like a set of rubber stamps or stickers. It lets you
paste pre-drawn or photographic images (like a picture of a horse, or a
@@ -364,12 +384,12 @@ b."Stamp" Tool (Rubber Stamps)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
- Stamp Categories
+ → Stamp Categories ←
There can be numerous categories of stamps (e.g., animals, plants,
outer space, vehicles, people, etc.). Use the Left and Right arrows
near the bottom of the Selector to cycle through the collections.
-
- Stamp Rotation
+
+ → Stamp Rotation ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@@ -386,8 +406,8 @@ b."Stamp" Tool (Rubber Stamps)
0.9.29.
-
- Stamp Controls
+
+ → Stamp Controls ←
Prior to 'stamping' an image onto your drawing, various effects can
sometimes be applied (depending on the stamp):
@@ -406,8 +426,8 @@ b."Stamp" Tool (Rubber Stamps)
Options" documentation.
-
- Stamp Sounds
+
+ → Stamp Sounds ←
Different stamps can have different sound effects and/or descriptive
(spoken) sounds. Buttons in the Help Area at the lower left (near Tux,
@@ -415,11 +435,11 @@ b."Stamp" Tool (Rubber Stamps)
descriptive sounds for the currently-selected stamp.
+
-
-
-c."Lines" Tool
+
+c."Lines" Tool ←
This tool lets you draw straight lines using the various brushes and colors
you normally use with the Paint Brush.
@@ -444,8 +464,8 @@ c."Lines" Tool
to learn more.
-
-d."Shapes" Tool
+
+d."Shapes" Tool ←
This tool lets you draw some simple filled, and un-filled shapes.
@@ -453,15 +473,15 @@ d."Shapes" Tool
Use the options at the bottom right to choose the shape tool's behavior:
- Shapes from center
+ → Shapes from center ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
-
- Shapes from corner
+
+ → Shapes from corner ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@@ -469,7 +489,7 @@ d."Shapes" Tool
📜 This option was added starting with Tux Paint version 0.9.25.
-
+
⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols"
option), the controls will not be presented, and the "shapes from center"
@@ -487,7 +507,7 @@ d."Shapes" Tool
Let go of the mouse when you're done stretching.
- Normal Shapes Mode
+ → Normal Shapes Mode ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@@ -497,8 +517,8 @@ d."Shapes" Tool
color.
-
- Simple Shapes Mode
+
+ → Simple Shapes Mode ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@@ -507,11 +527,11 @@ d."Shapes" Tool
("simpleshapes") option.
+
-
-
-e."Text" and "Label" Tools
+
+e."Text" and "Label" Tools ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@@ -532,7 +552,7 @@ e."Text" and "Label" Tools
causes the current line of text to move to that location (where you can
continue editing it).
- "Text" versus "Label"
+ → "Text" versus "Label" ←
The Text tool is the original text-entry tool in Tux Paint. Text
entered using this tool can't be modified or moved later, since it
@@ -567,8 +587,8 @@ e."Text" and "Label" Tools
option).
-
- International Character Input
+
+ → International Character Input ←
Tux Paint allows inputting characters in different languages. Most
Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some
@@ -594,8 +614,8 @@ e."Text" and "Label" Tools
trying to type.
-
- On-screen Keyboard
+
+ → On-screen Keyboard ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@@ -605,11 +625,11 @@ e."Text" and "Label" Tools
information.
+
-
-
-f."Fill" Tool
+
+f."Fill" Tool ←
The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a
color of your choice. Three fill options are offered:
@@ -632,8 +652,8 @@ f."Fill" Tool
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
-
-g."Magic" Tool (Special Effects)
+
+g."Magic" Tool (Special Effects) ←
The Magic tool is actually a set of special tools. Select one of the
'magic' effects from the selector on the right. Then, depending on the
@@ -683,8 +703,8 @@ g."Magic" Tool (Special Effects)
one large list. See the "Options" documentation.
-
-h."Eraser" Tool
+
+h."Eraser" Tool ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -716,11 +736,11 @@ h."Eraser" Tool
currently-selected tool.
+
+## 2. Other Controls ##
-2. Other Controls
-
-a."Undo" and "Redo" Commands
+a."Undo" and "Redo" Commands ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@@ -736,8 +756,8 @@ a."Undo" and "Redo" Commands
⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo.
-
-b."New" Command
+
+b."New" Command ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -751,14 +771,14 @@ b."New" Command
⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a
new drawing.
- Special Solid Background Color Choices
+ → Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Main Screen > Lower: Colors > Special color options for
details.
-
- 'Starter' & Template Images
+
+ 'Starter' & Template Images ←
o 'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color in,
and the black outline remains intact — or like a 3D photograph,
@@ -788,8 +808,8 @@ b."New" Command
within Tux Paint, from the 'Open' dialog. See "Open", below.
-
- Erasing Exported Template Images
+
+ → Erasing Exported Template Images ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@@ -805,14 +825,14 @@ b."New" Command
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
-
+
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
-
-c."Open" Command
+
+c."Open" Command ←
This shows you a list of all of the pictures you've saved. If there are
more than can fit on the screen, use the up and down arrows at the top and
@@ -864,8 +884,8 @@ c."Open" Command
the 'Open' dialog.
-
-d."Save" Command
+
+d."Save" Command ←
This saves your current picture.
@@ -885,8 +905,8 @@ d."Save" Command
⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save.
-
-e."Print" Command
+
+e."Print" Command ←
Click this button and your picture will be printed!
@@ -895,7 +915,7 @@ e."Print" Command
this may not work if you're running Tux Paint in fullscreen mode. See
below.
- Disabling Printing
+ → Disabling Printing ←
The "noprint" option can be set, which will disable Tux Paint's 'Print'
button.
@@ -903,8 +923,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Restricting Printing
+
+ → Restricting Printing ←
The "printdelay" option can be set, which will only allow occasional
printing — once every so many seconds, as configured by you.
@@ -915,8 +935,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printing Commands
+
+ → Printing Commands ←
(Linux and Unix only)
@@ -942,8 +962,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Settings
+
+ → Printer Settings ←
(Windows and macOS)
@@ -965,8 +985,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Dialog Options
+
+ → Printer Dialog Options ←
By default, Tux Paint only shows the printer dialog (or, on Linux/Unix,
runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the
@@ -981,17 +1001,17 @@ e."Print" Command
⚙ See the "Options" documentation.
+
-
-
-f."Slides" Command (under "Open")
+
+f."Slides" Command (under "Open") ←
The 'Slides' button is available in the 'Open' dialog. It can be used to
play a simple animation within Tux Paint, or a slideshow of pictures. It
can also export an animated GIF based on the chosen images.
- Chosing pictures
+ → Chosing pictures ←
When you enter the 'Slides' section of Tux Paint, it displays a list of
your saved files, just like the 'Open' dialog.
@@ -1005,8 +1025,8 @@ f."Slides" Command (under "Open")
list.
-
- Set playback speed
+
+ → Set playback speed ←
A sliding scale at the lower left of the screen (next to the 'Play'
button) can be used to adjust the speed of the slideshow or animated
@@ -1019,8 +1039,8 @@ f."Slides" Command (under "Open")
does not apply to an exported animated GIF.)
-
- Playback in Tux Paint
+
+ → Playback in Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@@ -1036,8 +1056,8 @@ f."Slides" Command (under "Open")
the slideshow and return to the slideshow image selection screen.
-
- Exporting an animated GIF
+
+ → Exporting an animated GIF ←
Click the 'GIF Export' button near the lower right to have Tux Paint
generate an animated GIF file based on the selected images.
@@ -1051,14 +1071,14 @@ f."Slides" Command (under "Open")
return you to the 'Slideshow' dialog.
-
+
Click 'Back' in the slideshow image selection screen to return to the
'Open' dialog.
-
-g."Quit" Command
+
+g."Quit" Command ←
Clicking the 'Quit' button, closing the Tux Paint window, or pushing the
[Escape] key will quit Tux Paint.
@@ -1085,8 +1105,8 @@ g."Quit" Command
⚙ See the "Options" documentation.
-
-h.Sound Muting
+
+h.Sound Muting ←
There is no on-screen control button at this time, but by using the [Alt] +
[S] keyboard sequence, sound effects can be disabled and re-enabled (muted
@@ -1099,11 +1119,11 @@ h.Sound Muting
⚙ See the "Options" documentation.
+
+ ### E. Controlling Tux Paint ###
-E. Controlling Tux Paint
-
-1. Using a Mouse or Trackball
+## 1. Using a Mouse or Trackball ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@@ -1119,7 +1139,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
-a. Scrolling
+# a. Scrolling #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@@ -1132,7 +1152,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
-b. Mouse Accessibility
+# b. Mouse Accessibility #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@@ -1145,7 +1165,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
-2. Using a Tablet or Touchscreen
+## 2. Using a Tablet or Touchscreen ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@@ -1157,7 +1177,7 @@ Some examples:
* Eraser tip
* Multi-touch gestures
-3. Using a Joystick-like Device
+## 3. Using a Joystick-like Device ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@@ -1171,7 +1191,7 @@ to different Tux Paint controls (e.g., acting as the [Escape] key, switching to
the Paint tool, invoking Undo and Redo operations, etc.). See the Options
documentation for more details.
-4. Using the Keyboard
+## 4. Using the Keyboard ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@@ -1180,7 +1200,7 @@ documentation for more details.
III. Loading Other Pictures into Tux Paint
-A. Overview
+ ### A. Overview ###
Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So
what do you do if you want to load some other drawinng or even a photograph
@@ -1190,29 +1210,29 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Note: It is also from this folder that you can copy or open pictures drawn in
Tux Paint using other applications, though the 'Export' option from Tux Paint's
'Open' dialog can be used to copy them to a location that's easier and safer to
access.
-B. Using the import script, "tuxpaint-import"
+ ### B. Using the import script, "tuxpaint-import" ###
Linux and Unix users can use the "tuxpaint-import" shell script which gets
installed when you install Tux Paint. It uses some NetPBM tools to convert the
@@ -1243,7 +1263,7 @@ following two lines are output from the program while it's working.
Now you can load Tux Paint, and a version of that original picture will be
available under the 'Open' dialog. Just double-click its icon!
-C. Importing Pictures Manually
+ ### C. Importing Pictures Manually ###
Windows, macOS, and Haiku users who wish to import arbitrary images into Tux
Paint must do so via a manual process.
@@ -1261,7 +1281,7 @@ Paint's canvas size. This size depends on the size of the Tux Paint window, or
resolution at which Tux Paint is run, if in fullscreen. (Note: The default
resolution is 800x600.) See "Calculating Image Dimensions", below.
-1. Naming the File
+## 1. Naming the File ##
Save the picture in PNG format. It is highly recommended that you name the
filename using the current date and time, since that's the convention Tux Paint
@@ -1280,7 +1300,7 @@ Example: "20210731110500.png", for July 31, 2021 at 11:05am.
Place this PNG file in your Tux Paint "saved" directory/folder. (See above.)
-2. Calculating Image Dimensions
+## 2. Calculating Image Dimensions ##
This part of the documentation needs to be rewritten, since the new
"buttonsize" option was added. For now, try drawing and saving an image within
@@ -1293,7 +1313,7 @@ IV.Further Reading
Other documentation included with Tux Paint (found in the "docs" folder/
directory) includes:
-Using Tux Paint:
+→ Using Tux Paint: ←
+ OPTIONS.html
Detailed instructions on command-line and configuration-file options,
for those who don't want to use the Tux Paint Config. tool to manage
@@ -1304,8 +1324,8 @@ Using Tux Paint:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-How to extend Tux Paint:
+
+→ How to extend Tux Paint: ←
+ EXTENDING.html
Detailed instructions on extending Tux Paint: creating brushes, stamps,
starters, and templates; adding fonts; and creating new on-screen
@@ -1316,8 +1336,8 @@ How to extend Tux Paint:
+ SVG.html
Notes on creating SVG format vector images for use in Tux Paint.
-
-Technical information:
+
+→ Technical information: ←
+ INSTALL.html
Instructions for compiling and installing Tux Paint, when applicable.
+ SIGNALS.html
@@ -1325,8 +1345,8 @@ Technical information:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
-
-Development history and license:
+
+→ Development history and license: ←
+ AUTHORS.txt
List of authors and contributors.
+ CHANGES.txt
@@ -1334,7 +1354,7 @@ Development history and license:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
-
+
V.How to Get Help
diff --git a/docs/en/SIGNALS.txt b/docs/en/SIGNALS.txt
index 1dec5e299..18f5f0174 100644
--- a/docs/en/SIGNALS.txt
+++ b/docs/en/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
-SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
+→ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@@ -32,8 +32,8 @@ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
the [Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/en/SVG.txt b/docs/en/SVG.txt
index 57a2e20a4..8f6b42486 100644
--- a/docs/en/SVG.txt
+++ b/docs/en/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Open Source
+→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Proprietary
+
+→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/en/html/EXTENDING.html b/docs/en/html/EXTENDING.html
index 18db00275..aac173177 100644
--- a/docs/en/html/EXTENDING.html
+++ b/docs/en/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the width of the canvas.
@@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the height of the canvas.
@@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
+
Focusing on the top of a starter image stretched to fit the width of the canvas.
@@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
+
Focusing on the bottom of a starter image stretched to fit the width of the canvas.
@@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
+
Focusing on the right of a starter image stretched to fit the height of the canvas.
diff --git a/docs/en/html/README.html b/docs/en/html/README.html
index 6f445da8a..b2b259ee3 100644
--- a/docs/en/html/README.html
+++ b/docs/en/html/README.html
@@ -102,7 +102,7 @@
- October 12, 2024
+ October 14, 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
New brushes
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+ New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
New brush option
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+ Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
New templates
- "Clouds from an airplane" and "Lough Leane".
+ "Clouds from an airplane" and "Lough Leane".
New Magic tool: Comic dots
Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
New Magic tool: ASCII Typewriter
- Transform your picture into "ASCII art", typewriter-style.
+ Transform your picture into "ASCII art", typewriter-style.
New Magic tool: ASCII Computer
- Transform your picture into "ASCII art", computer-style.
+ Transform your picture into "ASCII art", computer-style.
New Magic tool: ASCII Color Computer
- Transform your picture into colored computer "ASCII art".
+ Transform your picture into colored computer "ASCII art".
New Magic tool: Crescent
- Draw one of various crescent shapes at a chosen angle.
+ Draw one of various crescent shapes at a chosen angle.
New Magic tool: Spiral
- Draw spirals.
+ Draw spirals.
New Magic tool: Spiral Square
- Draw square spirals.
+ Draw square spirals.
New Magic tool: Concentric Circle
- Draw concentric circles.
+ Draw concentric circles.
New Magic tool: Concentric Square
- Draw concentric squares.
+ Draw concentric squares.
New Magic tool: Tessellation Pointy
- Draw repeating tessellation patterns with pointy-topped hexagons.
+ Draw repeating tessellation patterns with pointy-topped hexagons.
New Magic tool: Tessellation Flat
- Draw repeating tessellation patterns with flat-topped hexagons.
+ Draw repeating tessellation patterns with flat-topped hexagons.
Magic API Updates
- Sound pause and resume functions added.
+ Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Title screen]">
+
B. Title Screen
@@ -412,6 +413,7 @@
height="254"
alt=
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]">
+
Left Side: Toolbar
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Canvas]">
+
@@ -455,6 +458,7 @@
height="254"
alt=
"[Selectors - Brushes, Letters, Shapes, Stamps]">
+
@@ -476,6 +480,7 @@
height="254"
alt=
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
+
@@ -486,13 +491,14 @@
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.)
-
+
+

+
-
On the far right are three special color options:
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Example tip: 'Pick a shape. Click to pick the center, drag, then let go when it is the size you want. Move around to rotate it, and click to draw it.')">
+
-
diff --git a/docs/en/tuxpaint-quickstart-guide.txt b/docs/en/tuxpaint-quickstart-guide.txt
index e1a68e095..15162a06c 100644
--- a/docs/en/tuxpaint-quickstart-guide.txt
+++ b/docs/en/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Tux Paint 0.9.34 Quickstart Guide
-Tools (Drawing)
+ ### Tools (Drawing) ###
-🖌Paint
+## 🖌Paint ##
* Choose a brush on the right.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@@ -10,7 +10,7 @@ Tools (Drawing)
* Choose a color (see "Colors").
* Click/tap and drag in the canvas to paint.
-⌧Stamps
+## ⌧Stamps ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right.
@@ -27,12 +27,12 @@ Tools (Drawing)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
-⚟Lines
+## ⚟Lines ##
* (See Paint)
* Click/tap and drag to draw a line.
-⭓Shapes
+## ⭓Shapes ##
* Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a corner
@@ -40,7 +40,7 @@ Tools (Drawing)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
-🄰Text
+## 🄰Text ##
* Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@@ -60,7 +60,7 @@ Tools (Drawing)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
-🅰Label
+## 🅰Label ##
* (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@@ -74,7 +74,7 @@ Tools (Drawing)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
-🪣Fill
+## 🪣Fill ##
* Choose a fill mode on the right.
* Choose a color (see "Colors").
@@ -90,7 +90,7 @@ Tools (Drawing)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
-🪄Magic
+## 🪄Magic ##
* Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@@ -101,26 +101,26 @@ Tools (Drawing)
bottom right.
* Some magic tools allow you to choose their color.
-🖓Undo
+## 🖓Undo ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
-🖒Redo
+## 🖒Redo ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
-◪Eraser
+## ◪Eraser ##
* Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
-Tools (Controls)
+ ### Tools (Controls) ###
-🗏New
+## 🗏New ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@@ -131,7 +131,7 @@ Tools (Controls)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
-🕮⮫Open
+## 🕮⮫Open ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@@ -150,7 +150,7 @@ Tools (Controls)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
-🕮⮪Save
+## 🕮⮪Save ##
* Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite the
@@ -158,19 +158,19 @@ Tools (Controls)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
-🖶Print
+## 🖶Print ##
* Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Quit
+## 🗙Quit ##
* Click/tap to quit Tux Paint.
* Shortcut: [Escape]
-Colors
+ ### Colors ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@@ -194,7 +194,7 @@ Colors
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
-Shortcuts while drawing:
+ ### Shortcuts while drawing: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access
diff --git a/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index 66e732737..5ca9dcd1e 100644
--- a/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+----------------------------------------+
-------------------------------------------------------------------------------
-About this 'How-To'
+ ### About this 'How-To' ###
This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
@@ -32,9 +32,9 @@ About this 'How-To'
-------------------------------------------------------------------------------
-Image choice is crucial
+ ### Image choice is crucial ###
- License
+ ## License ##
If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to
@@ -55,7 +55,7 @@ Image choice is crucial
For personal use, any image you can legitimately modify and use for
your own personal use should be fine.
- Image Size and Orientation
+ ## Image Size and Orientation ##
You need an image that has a useful orientation. Perspective is an
enemy. Images that show an object from the corner are difficult to fit
@@ -82,7 +82,7 @@ Image choice is crucial
-------------------------------------------------------------------------------
-Prepare the image
+ ### Prepare the image ###
First of all, be sure to avoid re-saving the image as a JPEG. This causes
quality loss. There is a special tool called jpegtran that lets you crop an
@@ -119,7 +119,7 @@ Prepare the image
-------------------------------------------------------------------------------
-Prepare the mask
+ ### Prepare the mask ###
Get used to doing [Control]-click and [Alt]-click on the thumbnail images
in the layers dialog. You will need this to control what you are looking at
@@ -178,7 +178,7 @@ Prepare the mask
-------------------------------------------------------------------------------
-Replace the fringe and junk pixels
+ ### Replace the fringe and junk pixels ###
Still viewing the mask, select by color. Choose black. Shrink the selection
by several pixels, being sure to NOT shrink from the edges of the mask (the
@@ -240,7 +240,7 @@ Replace the fringe and junk pixels
-------------------------------------------------------------------------------
-Save the image for Tux Paint
+ ### Save the image for Tux Paint ###
It is very easy to ruin your hard work. Image editors can silently destroy
pixels in 0% opaque areas. The conditions under which this happens may vary
@@ -251,7 +251,7 @@ Save the image for Tux Paint
save space (and hide your mistakes), you are almost certain to destroy all
the 0% opaque areas. So here is a better way...
- A Safer Way to Save
+ ## A Safer Way to Save ##
Drag the mask from the layers dialog to the unused portion of the
toolbar (right after the last drawing tool). This will create a new
diff --git a/docs/es_ES.UTF-8/ENVVARS.txt b/docs/es_ES.UTF-8/ENVVARS.txt
index d137d6695..9b6e422c3 100644
--- a/docs/es_ES.UTF-8/ENVVARS.txt
+++ b/docs/es_ES.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.
-Storage-related environment variables
+ ### Storage-related environment variables ###
-HOME
+→ HOME ←
Specifies the user's "home directory", which is used to locate numerous
other files or directories. In some cases, it is utilized as part of a
@@ -30,8 +30,8 @@ HOME
+ The location of a user's private collection of data files — stamps,
brushes, etc. — (versus those available system wide)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@@ -42,8 +42,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@@ -53,18 +53,18 @@ XDG_DATA_HOME
anywhere.
-
-TEMP
+
+→ TEMP ←
Specifies the location where temporary files may be created. Only used by
Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
-Language-related environment variables
+ ### Language-related environment variables ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -73,24 +73,24 @@ LC_MESSAGES
and finally "LANG".
+
-
-Display-related environment variables
+ ### Display-related environment variables ###
The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
to '1' (true) by Tux Paint itself by issuing the command-line option
"--allowscreensaver" or its configuration file counterpart.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@@ -99,5 +99,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").
-
+
diff --git a/docs/es_ES.UTF-8/EXTENDING.txt b/docs/es_ES.UTF-8/EXTENDING.txt
index 66406cdff..fc0b30c53 100644
--- a/docs/es_ES.UTF-8/EXTENDING.txt
+++ b/docs/es_ES.UTF-8/EXTENDING.txt
@@ -44,11 +44,11 @@ changing, or removing files where Tux Paint looks for them.
Where Files Go
-Standard Files
+ ### Standard Files ###
Tux Paint looks for its various data files in its 'data' directory.
-Linux and Unix
+→ Linux and Unix ←
Where this directory goes depends on what value was set for "DATA_PREFIX"
when Tux Paint was built. See 'Install documentation' for details.
@@ -62,8 +62,8 @@ Linux and Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint looks for a directory called 'data' in the same directory as the
executable. This is the directory that the installer used when installing
@@ -72,8 +72,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint stores its data files inside the "Tux Paint" application icon
(which is actually a special kind of folder on macOS & Mac OS X before it).
@@ -106,14 +106,14 @@ macOS
Tux Paint.
+
-
-Personal Files
+ ### Personal Files ###
You can also create brushes, stamps, 'starters', templates, and fonts in your
own user account directory (folder) for Tux Paint to find.
-Windows
+→ Windows ←
Your personal Tux Paint folder is stored in your personal "Application
Data". For example, on newer Windows:
@@ -121,8 +121,8 @@ Windows
C:\Users\username\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -130,8 +130,8 @@ macOS
/Users/username/Library/Application Support/TuxPaint/
-
-Linux and Unix
+
+→ Linux and Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/username/.tuxpaint/".
@@ -139,7 +139,7 @@ Linux and Unix
Don't forget the period (".") before the "tuxpaint"!
-
+
To add your own brushes, stamps, 'starters,' templates, and fonts, create
subdirectories under your personal Tux Paint directory named "brushes", "stamps
@@ -160,7 +160,7 @@ partially-transparent!
Greyscale pixels in the brush PNG will be drawn using the currently-selected
color in Tux Paint. Color pixels will be tinted.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -170,7 +170,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -190,17 +190,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Brush Options
+ ### Brush Options ###
Aside from a graphical shape, brushes can also be given other attributes. To do
this, you need to create a 'data file' for the brush.
@@ -212,7 +212,7 @@ The file has the same name as the PNG image, but a ".dat" extension. (e.g.,
"brush.png"'s data file is the text file "brush.dat", found in the same
directory.)
-Brush Spacing
+→ Brush Spacing ←
As of Tux Paint version 0.9.16, you can now specify the spacing for brushes
(that is, how often they are drawn). By default, the spacing will be the
@@ -223,8 +223,8 @@ Brush Spacing
often the brush is drawn.)
-
-Animated Brushes
+
+→ Animated Brushes ←
As of Tux Paint version 0.9.16, you may now create animated brushes. As the
brush is used, each frame of the animation is drawn.
@@ -239,8 +239,8 @@ Animated Brushes
sequentially, also add a line containing "random" to the brush's data file.
-
-Directional Brushes
+
+→ Directional Brushes ←
As of Tux Paint version 0.9.16, you may now create directional brushes. As
the brush is used, different shapes are drawn, depending on the direction
@@ -255,8 +255,8 @@ Directional Brushes
Add a line containing the word "directional" to the brush's data file.
-
-Rotating Brushes
+
+→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@@ -265,8 +265,8 @@ Rotating Brushes
Add a line containing the word "rotate" to the brush's data file.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -274,8 +274,8 @@ Chaotic Brushes
Add a line containing the word "chaotic" to the brush's data file.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -289,7 +289,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Place the brush image PNGs (and any data text files) in the "brushes"
directory.
@@ -305,7 +305,7 @@ subdirectories and sub-subdirectories there to organize the stamps. (For
example, you can have a "holidays" folder with "halloween" and "christmas"
sub-folders.)
-Stamp Images
+ ### Stamp Images ###
Rubber Stamps in Tux Paint can be made up of a number of separate files. The
one file that is required is, of course, the picture itself.
@@ -334,7 +334,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
how to make PNG images which will scale perfectly when used as stamps in Tux
Paint.
-Stamp Descriptive Text
+ ### Stamp Descriptive Text ###
Tux Paint will display descriptive text when a stamp is selected. These are
placed in plain text files with the same name as the PNG or SVG, but with a
@@ -344,7 +344,7 @@ placed in plain text files with the same name as the PNG or SVG, but with a
The first line of the text file will be used as the US English description of
the stamp's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -364,17 +364,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Stamp Sound Effects
+ ### Stamp Sound Effects ###
Tux Paint can play a sound effect when a stamp is selected. For example, the
sound of a duck quaking when selecting a duck, or a brief piece of music when a
@@ -383,7 +383,7 @@ musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis
"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same
directory.)
-Localization Support
+→ Localization Support ←
For sounds for different locales (e.g., if the sound is someone saying a
word, and you want translated versions of the word said), also create WAV
@@ -400,12 +400,12 @@ Localization Support
the 'default' sound file. (e.g., "stamp.wav")
-
+
💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound',
below.
-Stamp Descriptive Sound
+ ### Stamp Descriptive Sound ###
Tux Paint can also play a descriptive sound when a stamp is selected. For
example, the sound of someone saying the word "duck" when selecting a duck, or
@@ -414,7 +414,7 @@ the name of a musical instrument when one is chosen. Files may be in "WAVE
or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound
is the sound file "stamp_desc.ogg" in the same directory.)
-Localization Support
+→ Localization Support ←
For descriptive sounds for different locales, also create WAV or OGG files
with both "_desc" and the locale's label in the filename, in the form:
@@ -430,9 +430,9 @@ Localization Support
load the 'default' sound file. (e.g., "stamp_desc.wav")
+
-
-Stamp Options
+ ### Stamp Options ###
Aside from a graphical shape, a textual description, a sound effect, and a
descriptive sound, stamps can also be given other attributes. To do this, you
@@ -445,11 +445,11 @@ The file has the same name as the PNG or SVG image, but a ".dat" extension.
(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same
directory.)
-Colored Stamps
+→ Colored Stamps ←
Stamps can be made to be either "colorable" or "tintable."
- Colorable
+ → Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@@ -461,8 +461,8 @@ Colored Stamps
Add a line containing the word "colorable" to the stamp's data file.
-
- Tinted
+
+ → Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@@ -472,14 +472,14 @@ Colored Stamps
Add a line containing the word "tintable" to the stamp's data file.
-
- Tinting Options:
+
+ → Tinting Options: ←
Depending on the contents of your stamp, you might want to have Tux
Paint use one of a number of methods when tinting it. Add one of the
following lines to the stamp's data file:
- Normal tinter — "tinter=normal" (the default)
+ → Normal tinter — "tinter=normal" (the default) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@@ -490,28 +490,28 @@ Colored Stamps
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
-
- Narrow tinter — "tinter=narrow"
+
+ → Narrow tinter — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- 'Any hue' tinter — "tinter=anyhue"
+
+ → 'Any hue' tinter — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Vector tinter — "tinter=vector"
+
+ → Vector tinter — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
+
+
-
-
-
-Unalterable Stamps
+
+→ Unalterable Stamps ←
By default, a stamp can be flipped upside down, shown as a mirror image, or
both. This is done using the control buttons below the stamp selector, at
@@ -528,8 +528,8 @@ Unalterable Stamps
nomirror" to the stamp's data file.
-
-Initial Stamp Size
+
+→ Initial Stamp Size ←
By default, Tux Paint assumes that your stamp is sized appropriately for
unscaled display on a 608x472 canvas. This was the original Tux Paint
@@ -548,17 +548,17 @@ Initial Stamp Size
+ "scale 2.5"
+ "scale 2:5"
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".dat" extension at the end of the
filename.
+
-
-Pre-Mirrored and Flipped Stamps
+ ### Pre-Mirrored and Flipped Stamps ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@@ -598,7 +598,7 @@ When you use a 'starter' image, make modifications, and save it, the original
'starter' image is not overwritten. Additionally, as you edit your new picture,
the contents of the original 'starter' can affect it.
-Coloring-Book Style Starters
+ ### Coloring-Book Style Starters ###
The most basic kind of 'starter' is similar to a picture in a coloring book.
It's an outline of a shape which you can then color in and add details to. In
@@ -612,7 +612,7 @@ SVG. If saving as a PNG, you may optionally render the image as
black-and-transparent, rather than black-and-white, but (as of Tux Paint
0.9.21) this is not required.
-Scene-Style Starters
+ ### Scene-Style Starters ###
Along with the 'coloring-book' style overlay, you can also provide a separate
background image as part of a 'starter' picture. The overlay acts the same: it
@@ -651,7 +651,7 @@ allows it to continue to affect the drawing even after Tux Paint has been quit,
or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a 'starter' image, it will always be affected by it.)
-Starter Options
+ ### Starter Options ###
Aside from an image, starters can also be given other attributes. To do this,
you need to create a 'data file' for the starter. (Note: Tux Paint prior to
@@ -664,7 +664,7 @@ The file has the same name as the image, but a ".dat" extension. (e.g.,
"starter.png"'s data file is the text file "starter.dat", found in the same
directory.)
-allowscale
+→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@@ -703,8 +703,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
-
-background
+
+→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@@ -722,8 +722,8 @@ background
details.
-
-gravity
+
+→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@@ -747,6 +747,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
+
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@@ -754,6 +755,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
+
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@@ -761,12 +763,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
+
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
+
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@@ -774,13 +778,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
+
Focusing on the right of a starter image stretched to fit the height of the
canvas.
-
+
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@@ -822,7 +827,7 @@ quit, or another picture is loaded or a new image is created. (In other words,
if you base a drawing on a 'template' image, it will always be affected by it.)
-Template Options
+ ### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@@ -963,7 +968,7 @@ layouts).
We'll use the QWERTY keyboard as an example:
-Layout overview file ("qwerty.layout")
+ ### Layout overview file ("qwerty.layout") ###
This is a text file that specifies the other files used to describe the layout
and key mappings.
@@ -981,7 +986,7 @@ seen in the example above.
The "keyboardlist" line describes which layouts to switch to, when the user
clicks the left and right buttons on the keyboard. (See below.)
-Keyboard layout file ("qwerty.h_layout")
+ ### Keyboard layout file ("qwerty.h_layout") ###
This describes how big the keyboard is (as a "width × height" grid), and lists
each key with its numeric keycode (see the "keymap" file, below), the width it
@@ -1045,7 +1050,7 @@ described below.
* 1 — next layout (per the layout file's "keyboardlist" setting)
* 2 — previous layout (per the layout file's "keyboardlist" setting)
-Keymap file ("us-intl-altgr-dead-keys.keymap")
+ ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@@ -1085,7 +1090,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Composemap file ("en_US.UTF-8_Compose")
+ ### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the
@@ -1096,7 +1101,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
-Keysym definitions file ("keysymdef.h")
+ ### Keysym definitions file ("keysymdef.h") ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"
diff --git a/docs/es_ES.UTF-8/FAQ.txt b/docs/es_ES.UTF-8/FAQ.txt
index b56d6c00f..e7d7c2fc9 100644
--- a/docs/es_ES.UTF-8/FAQ.txt
+++ b/docs/es_ES.UTF-8/FAQ.txt
@@ -21,15 +21,15 @@
+------------------------------+
-------------------------------------------------------------------------------
-Drawing-related
+ ### Drawing-related ###
-Fonts I added to Tux Paint only show squares
+→ Fonts I added to Tux Paint only show squares ←
The TrueType Font you're using might have the wrong encoding. If it's
'custom' encoded, for example, you can try running it through FontForge (
http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
(Email us if you need help with special fonts.)
-
-The Rubber Stamp tool is greyed out!
+
+→ The Rubber Stamp tool is greyed out! ←
This means that Tux Paint either couldn't find any stamp images, or was
asked not to load them.
@@ -55,8 +55,8 @@ The Rubber Stamp tool is greyed out!
configuration file.
-
-Stamp outlines are always rectangles
+
+→ Stamp outlines are always rectangles ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@@ -68,13 +68,13 @@ Stamp outlines are always rectangles
in the "tuxpaint.c" file in the "src" directory.
-
+
-------------------------------------------------------------------------------
-Interface Problems
+ ### Interface Problems ###
-Stamp thumbnails in the Stamp Selector look bad
+→ Stamp thumbnails in the Stamp Selector look bad ←
Tux Paint was probably compiled with the faster, lower quality thumbnail
code enabled. Run the command: "tuxpaint --verbose-version" from a command
@@ -89,24 +89,24 @@ Stamp thumbnails in the Stamp Selector look bad
in the "tuxpaint.c" file in the "src" directory.
-
-Pictures in the 'Open' dialog look bad
+
+→ Pictures in the 'Open' dialog look bad ←
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
Stamp Selector look bad", above.
-
-All of the text is in uppercase!
+
+→ All of the text is in uppercase! ←
The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override it with
"--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
yes" in a configuration file.
-
-Tux Paint is in a different language
+
+→ Tux Paint is in a different language ←
Make sure your locale setting is correct. See "Tux Paint won't switch to my
language", below.
-
-Tux Paint won't switch to my language
+
+→ Tux Paint won't switch to my language ←
+ Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your "/etc/
@@ -142,13 +142,13 @@ Tux Paint won't switch to my language
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Printing
+ ### Printing ###
-Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
+→ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) ←
Tux Paint prints by creating a PostScript rendition of the picture and
sending it to an external command. By default, this command is the "lpr"
@@ -167,8 +167,8 @@ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
you will need to go back and alter it to accept PostScript.
-
-I get the message "You can't print yet!" when I go to print
+
+→ I get the message "You can't print yet!" when I go to print ←
The "print delay" option is on. You can only print once every X seconds.
@@ -190,8 +190,8 @@ I get the message "You can't print yet!" when I go to print
allow unlimited printing. (You won't have to wait between prints.)
-
-I simply can't print! The button is greyed out!
+
+→ I simply can't print! The button is greyed out! ←
The "no print" option is on.
@@ -212,41 +212,41 @@ I simply can't print! The button is greyed out!
is checked.
-
+
-------------------------------------------------------------------------------
-Saving
+ ### Saving ###
-Where does Tux Paint save my drawings?
+→ Where does Tux Paint save my drawings? ←
Unless you asked Tux Paint to save into a specific location (using the
"savedir" option), Tux Paint saves into a standard location on your local
drive:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
The images are stored as PNG bitmaps, which most modern programs should be
able to load (image editors, word processors, web browsers, etc.)
-
-Tux Paint always saves over my old picture
+
+→ Tux Paint always saves over my old picture ←
The "save over" option is enabled. (This disables the prompt that would
appear when you click 'Save.')
@@ -271,8 +271,8 @@ Tux Paint always saves over my old picture
Also, see "Tux Paint always saves a new picture!", below.
-
-Tux Paint always saves a new picture!
+
+→ Tux Paint always saves a new picture! ←
The "never save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@@ -297,13 +297,13 @@ Tux Paint always saves a new picture!
Also, see "Tux Paint always saves over my old picture!", above.
-
+
-------------------------------------------------------------------------------
-Audio Problems
+ ### Audio Problems ###
-There's no sound!
+→ There's no sound! ←
+ First, check the obvious:
o Are your speakers connected and turned on?
o Is the volume turned up on your speakers?
@@ -363,8 +363,8 @@ There's no sound!
headers are available!
-
-Tux Paint makes too much noise! Can I turn them off?
+
+→ Tux Paint makes too much noise! Can I turn them off? ←
Yes, there are a number of ways to disable sounds in Tux Paint:
@@ -380,9 +380,9 @@ Tux Paint makes too much noise! Can I turn them off?
o Alternatively, recompile Tux Paint with sound support disabled.
(See above, and the 'Install' documentation.
-
-The stereo panning of sound effects is bothersome; can sound effects be
- monophonic?
+
+→ The stereo panning of sound effects is bothersome; can sound effects be
+ monophonic? ←
Run Tux Paint with the "no stereo" option:
@@ -393,8 +393,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
"Video & Sound") is not checked.
-
-The sound effects sound strange
+
+→ The sound effects sound strange ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@@ -404,16 +404,17 @@ The sound effects sound strange
"tuxpaint --version" to verify), and so on.)
-
+
-------------------------------------------------------------------------------
-Fullscreen Mode Problems
+ ### Fullscreen Mode Problems ###
-When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
+→ When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns
+ black! ←
This is apparently a bug in the SDL library. Sorry.
-
-When I run Tux Paint full-screen, it has large borders around it
+
+→ When I run Tux Paint full-screen, it has large borders around it ←
Linux users - Your X-Window server is probably not set with the ability to
switch to the desired resolution: 800×600. (or whatever resolution you have
@@ -440,8 +441,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
-
-Tux Paint keeps running in Full Screen mode - I want it windowed!
+
+→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
The "fullscreen" option is set.
@@ -464,20 +465,21 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
is not checked.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-
+
-------------------------------------------------------------------------------
-Other Problems
+ ### Other Problems ###
-Tux Paint won't run
+→ Tux Paint won't run ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -503,8 +505,8 @@ Tux Paint won't run
command-line, or "nolockfile=yes" to the configuration file.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -526,8 +528,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-I can't quit Tux Paint
+
+→ I can't quit Tux Paint ←
The "no quit" option is set. This disables the "Quit" button in Tux Paint's
toolbar (greying it out), and prevents Tux Paint from being exited via the
@@ -543,8 +545,8 @@ I can't quit Tux Paint
combination on your keyboard to quit Tux Paint.)
-
-I don't want "no quit" mode enabled!
+
+→ I don't want "no quit" mode enabled! ←
If you're running Tux Paint from a command-line, make sure you're not
giving it a "--noquit" option.
@@ -563,8 +565,8 @@ I don't want "no quit" mode enabled!
Key" (under "Simplification") is not checked.
-
-Tux Paint keeps writing weird messages to the screen / to a text file
+
+→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@@ -578,8 +580,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
in the "tuxpaint.c" file in the "src" directory.
-
-Tux Paint is using options I didn't specify!
+
+→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@@ -656,11 +658,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Help / Contact
+ ### Help / Contact ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:
diff --git a/docs/es_ES.UTF-8/INSTALL.txt b/docs/es_ES.UTF-8/INSTALL.txt
index e43176f4c..81c2081f0 100644
--- a/docs/es_ES.UTF-8/INSTALL.txt
+++ b/docs/es_ES.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Requirements
-Simple DirectMedia Layer library (libSDL)
+ ### Simple DirectMedia Layer library (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Other Libraries
+## Other Libraries ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
-libPNG
+→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Linux/Unix only)
+
+→ libpaper (Linux/Unix only) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@@ -92,8 +92,8 @@ libpaper (Linux/Unix only)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
-
-SVG graphics support
+
+→ SVG graphics support ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
- librsvg-2 & libCairo2 (newer libraries)
+ → librsvg-2 & libCairo2 (newer libraries) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o These also depend on the following:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Older SVG libraries
+
+ → Older SVG libraries ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o These also depend on the following:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Animated GIF Export feature
+
+→ Animated GIF Export feature ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@@ -133,8 +133,8 @@ Animated GIF Export feature
https://github.com/ImageOptim/libimagequant
-
-NetPBM Tools (optional) No longer used, by default
+
+→ NetPBM Tools (optional) No longer used, by default ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@@ -144,7 +144,7 @@ NetPBM Tools (optional) No longer used, by default
http://netpbm.sourceforge.net/
-
+
Compiling and Installation
@@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
julio 10, 2022 Shin-ichi TOYAMA
-Compiling Set-Up
+## Compiling Set-Up ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@@ -207,7 +207,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@@ -264,7 +264,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -365,7 +365,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -393,7 +393,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Building the Tux Paint Windows Installer
+## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Running the Tux Paint Windows Installer
+## Running the Tux Paint Windows Installer ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
-Changing the Settings Using the Shortcut
+## Changing the Settings Using the Shortcut ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@@ -460,7 +460,7 @@ pushed the "Apply" button!).
When you have finished, click "OK."
-If Something Goes Wrong
+## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -474,9 +474,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compiling:
+## Compiling: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -487,7 +487,8 @@ shell prompt (e.g., "$"):
$ make
-Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+## Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@@ -495,7 +496,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
-Disabling Sound at Compile-time
+## Disabling Sound at Compile-time ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@@ -503,12 +504,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
-Other options
+## Other options ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
-If you get errors
+## If you get errors ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@@ -516,7 +517,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
-Installng
+## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@@ -542,7 +543,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Changing Where Things Go
+# Changing Where Things Go #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@@ -551,48 +552,48 @@ default, set to "/usr/local".
Other variables are:
-BIN_PREFIX
+→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
junio 5, 2022 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Prerequisites
+## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -628,7 +629,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -640,7 +641,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -654,7 +655,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-How to Build
+## How to Build ##
Simply, run:
@@ -668,7 +669,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Known Issues
+## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -685,7 +686,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Old Versions of macOS
+## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -725,7 +726,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Recompiling MacPorts
+## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -749,7 +750,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Building a Universal Binary
+## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -763,7 +764,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
marzo 29, 2023 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -772,7 +773,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Prerequisites
+## Prerequisites ##
You will need recent versions of:
@@ -797,7 +798,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Building
+## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -826,36 +827,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
mayo 7, 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Prerequisites
+## Prerequisites ##
Install the required develop packages in Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Building
+## Building ##
make PREFIX=/boot/home/config/non-packaged
-Tux Paint Stamps
+## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -868,9 +870,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
-Windows
+ ### Windows ###
-Using the Uninstaller
+## Using the Uninstaller ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@@ -879,19 +881,19 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
When it has finished, click on the close button.
-Using the Control Panel
+## Using the Control Panel ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
"/Library/Application Support/TuxPaint/" (all users) and
"/Users/username/Library/Application Support/TuxPaint/" (individual users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/es_ES.UTF-8/MAGIC-API.txt b/docs/es_ES.UTF-8/MAGIC-API.txt
index b08eb7c24..94acb5353 100644
--- a/docs/es_ES.UTF-8/MAGIC-API.txt
+++ b/docs/es_ES.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/es_ES.UTF-8/OPTIONS.txt b/docs/es_ES.UTF-8/OPTIONS.txt
index 5c1c86ba4..64f2e44c2 100644
--- a/docs/es_ES.UTF-8/OPTIONS.txt
+++ b/docs/es_ES.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
versión 0.9.34
- Options Documentation
+ ### Options Documentation ###
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -45,11 +45,11 @@ each time you start it up.
The file is simply a plain text file containing the options you want enabled:
-Linux and Unix Users
+ ### Linux and Unix Users ###
/home/username/.tuxpaintrc
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -57,11 +57,11 @@ at:
/etc/tuxpaint/tuxpaint.conf
-macOS Users
+ ### macOS Users ###
/Users/username/Library/Application Support/TuxPaint/tuxpaint.cfg
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -69,14 +69,14 @@ at:
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Windows Users
+ ### Windows Users ###
C:\Users\username\AppData\Roaming\TuxPaint\tuxpaint.cfg
You can use NotePad or WordPad to create this file. Be sure to save it as Plain
Text, and make sure the filename doesn't have ".txt" at the end...
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -84,7 +84,7 @@ at:
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -97,11 +97,11 @@ Available Options
The following settings can be set in the configuration file. (Command-line
settings will override these. See the "Command-Line Options" section, below.)
-Video/Sound
+ ### Video/Sound ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Run the program in full screen mode, rather than in a window.
@@ -110,15 +110,15 @@ fullscreen=yes
overridden by the command-line option "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Run the program in full screen mode. Additionally, assume the screen's
current resolution (set by the operating system).
-
-windowsize=SIZE
+
+→ windowsize=SIZE ←
Run the program at a different size (in windowed mode) or at a different
screen resolution (in fullscreen mode), rather than the default (usually
@@ -140,8 +140,8 @@ windowsize=SIZE
of the display, Tux Paint will fall back to the display's dimensions.
-
-orient=portrait
+
+→ orient=portrait ←
Swaps the width/height options given to Tux Paint, useful for rotating the
window on portait displays, such as a tablet PC that's in tablet
@@ -152,16 +152,16 @@ orient=portrait
be overridden by the command-line option "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
When running Tux Paint in fullscreen mode, this assumes the screen's
current resolution (overriding any "windowsize" option), as set by the
operating system.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -174,11 +174,11 @@ allowscreensaver=yes
command-line option "--disablescreensaver".
+
+## Sound ##
-Sound
-
-nosound=yes
+→ nosound=yes ←
Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to
reenable sounds if they were disabled using this option.)
@@ -188,8 +188,8 @@ nosound=yes
cases, may be overridden by the command-line option "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Disable stereo panning support. (Useful for users with hearing impairment
in one ear, or places where a single speaker or headphone is being used.)
@@ -199,11 +199,11 @@ nostereo=yes
cases, may be overridden by the command-line option "--stereo".
+
+## Interface Size ##
-Interface Size
-
-buttonsize=SIZE
+→ buttonsize=SIZE ←
Set the pixel size of buttons in Tux Paint's user interface (overriding the
default of "48"). Useful when using very high-density displays or coarse
@@ -224,8 +224,8 @@ buttonsize=SIZE
stderr.)
-
-colorsrows=ROWS
+
+→ colorsrows=ROWS ←
How many rows of color palette buttons to show; useful when using a large
color palette (see "colorfile", above), and/or for use with coarse input
@@ -233,13 +233,13 @@ colorsrows=ROWS
and "3".
+
+ ### Mouse/Keyboard ###
-Mouse/Keyboard
+## Cursor ##
-Cursor
-
-nofancycursors=yes
+→ nofancycursors=yes ←
This disables the fancy mouse pointer shapes in Tux Paint, and uses your
environment's normal mouse pointer.
@@ -253,8 +253,8 @@ nofancycursors=yes
"--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
This completely hides the mouse pointer shapes in Tux Paint.
@@ -265,11 +265,11 @@ hidecursor=yes
both cases, may be overridden by the command-line option "--showcursor".
+
+## Keyboard ##
-Keyboard
-
-noshortcuts=yes
+→ noshortcuts=yes ←
This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for
a new image, etc.)
@@ -282,11 +282,11 @@ noshortcuts=yes
both cases, may be overridden by the command-line option "--shortcuts".
+
+## Mouse ##
-Mouse
-
-grab=yes
+→ grab=yes ←
Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse
is confined to Tux Paint's window, and nearly all keyboard input is passed
@@ -301,8 +301,8 @@ grab=yes
cases, may be overridden by the command-line option "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
This disables support for the wheel on mice that have it. (Normally, the
wheel will scroll the selector menu on the right.)
@@ -312,8 +312,8 @@ nowheelmouse=yes
In both cases, may be overridden by the command-line option "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could
also be used for clicking. In version 0.9.15, it was changed so that only
@@ -330,13 +330,13 @@ nobuttondistinction=yes
command-line option "--buttondistinction".
+
+ ### Simplification ###
-Simplification
+## Interface Simplification ##
-Interface Simplification
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Disable the rotation step of the 'Shape' tool. Click, drag and release is
all that will be needed to draw a shape.
@@ -347,8 +347,8 @@ simpleshapes=yes
"--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
In this mode, much simpler outlines and 'rubber-band' lines are displayed
when using the Lines, Shapes, Stamps and Eraser tools.
@@ -361,8 +361,8 @@ nooutlines=yes
both cases, may be overridden by the command-line option "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
All text will be rendered only in uppercase (e.g., "Brush" will be
"BRUSH"). Useful for children who can read, but who have only learned
@@ -373,11 +373,11 @@ uppercase=yes
both cases, may be overridden by the command-line option "--mixedcase".
+
+## Initial Stamp Size ##
-Initial Stamp Size
-
-stampsize=SIZE
+→ stampsize=SIZE ←
Use this option to force Tux Paint to set the starting size of all stamps.
The SIZE value should be between 0 (smallest) and 10 (largest). The size is
@@ -387,11 +387,11 @@ stampsize=SIZE
Specify "default" to let Tux Paint decide (its standard behavior).
+
+## Control Simplification ##
-Control Simplification
-
-noquit=yes
+→ noquit=yes ←
Disable the on-screen "Quit" button and prevent the [Escape] key from
quitting Tux Paint.
@@ -408,8 +408,8 @@ noquit=yes
cases, may be overridden by the command-line option "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
This option tells Tux Paint to not load any rubber stamp images, which in
turn ends up disabling the Stamps tool.
@@ -422,8 +422,8 @@ nostamps=yes
cases, may be overridden by the command-line option "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Some images in the Stamps tool can be mirrored, flipped, and/or have their
size changed. This option disables the controls, and only provides the
@@ -435,8 +435,8 @@ nostampcontrols=yes
"--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
This disables the rotation step of the Stamps tool, immediately placing the
stamp in its regular orientation (with any flipping or mirroring applied)
@@ -451,8 +451,8 @@ nostamprotation=yes
"--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Some Magic tools have the option of acting like a paintbrush, or affecting
the entire canvas at once. This option disables the controls, and only
@@ -464,8 +464,8 @@ nomagiccontrols=yes
"--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Some Magic tools offer various size settings. This option disables the
sizing control, and only provides the tools' default sizes. (Some plugins
@@ -477,8 +477,8 @@ nomagicsizes=yes
In both cases, may be overridden by the command-line option "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -494,8 +494,8 @@ ungroupmagictools=yes
option "--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Disable the control buttons shown when using the Shapes tool that allow
changing how shapes are drawn — centered around the initial mouse click, or
@@ -507,8 +507,8 @@ noshapecontrols=yes
"--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Disables the Label tool: the tool that allows text entry which can be
edited later.
@@ -518,8 +518,8 @@ nolabel=yes
cases, may be overridden by the command-line option "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Disables the brush spacing option of the Paint and Lines tools. The
brushes' default spacings will be used.
@@ -533,8 +533,8 @@ nobrushspacing=yes
"--brushspacing".
-
-complexity=COMPLEXITY
+
+→ complexity=COMPLEXITY ←
Sets the complexity (expertise) level of Tux Paint, which can either
disable some Magic tools, or cause them to operate differently. (For
@@ -544,18 +544,18 @@ complexity=COMPLEXITY
The COMPLEXITY value may be one of:
- advanced (the default)
+ → advanced (the default) ←
"Advanced" — For users familiar with Tux Paint and who can operate more
complex tools.
-
- beginner
+
+ → beginner ←
"Beginner" — For users comfortable with Tux Paint, but where complex
tools may cause confusion or frustration.
-
- novice
+
+ → novice ←
"Novice" — For first-time Tux Paint users, users inexperienced with
computers, or those with special accessibility needs.
-
+
📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
Consult the individual Magic tools' documentation.
@@ -565,8 +565,8 @@ complexity=COMPLEXITY
may be overridden by the command-line option "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Disables the ability to create a new Template image (based on a saved
drawing) from within the Open dialog.
@@ -580,8 +580,8 @@ notemplateexport=yes
option "--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Disables the ability to erase saved drawings via the "Erase" button on the
Open dialog, or exported Template images (based on a saved drawing) via the
@@ -595,13 +595,13 @@ noerase=yes
cases, may be overridden by the command-line option "--erase".
+
+ ### Languages ###
-Languages
+## Language ##
-Language
-
-lang=LANGUAGE
+→ lang=LANGUAGE ←
Run Tux Paint in one of the supported languages. Possible choices for
LANGUAGE currently include:
@@ -863,8 +863,8 @@ lang=LANGUAGE
+-----------------------------------------------------------------+
-
---locale LOCALE
+
+→ --locale LOCALE ←
Run Tux Paint in one of the support languages. See the "Choosing a
Different Language" section below for the locale strings (e.g., "de_DE" for
@@ -875,8 +875,8 @@ lang=LANGUAGE
setting, if possible.)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
For stamps that can be mirrored, this option sets them to their mirrored
shape by default.
@@ -890,11 +890,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Fonts ##
-Fonts
-
-sysfonts=yes
+→ sysfonts=yes ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -905,8 +905,8 @@ sysfonts=yes
both cases, may be overridden by the command-line option "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts
directory, including locale-specific ones (e.g., the one for Tibetan, which
@@ -922,8 +922,8 @@ alllocalefonts=yes
command-line option "--currentlocalefont".
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -933,19 +933,19 @@ uifont=FONT NAME
standard behavior).
+
+ ### Printing ###
-Printing
+## Print Permissions ##
-Print Permissions
-
-noprint=yes
+→ noprint=yes ←
Disable the printing feature.
-
-printdelay=SECONDS
+
+→ printdelay=SECONDS ←
Restrict printing so that printing can occur only once every SECONDS
seconds.
@@ -955,11 +955,11 @@ printdelay=SECONDS
overridden by the command-line option "--printdelay=0".
+
+## Show Printer Dialog ##
-Show Printer Dialog
-
-altprint=always
+→ altprint=always ←
This causes Tux Paint to always show the printer dialog (or, on Linux/Unix,
run the "altprintcommand") when the 'Print' button is clicked. In other
@@ -967,8 +967,8 @@ altprint=always
need to hold [Alt] every time.
-
-altprint=never
+
+→ altprint=never ←
This prevents Tux Paint from ever showing the printer dialog (or, on Linux/
Unix, run the "altprintcommand") when the 'Print' button is clicked. In
@@ -976,8 +976,8 @@ altprint=never
'Print' button.
-
-altprint=mod
+
+→ altprint=mod ←
This is the normal, default behavior. Tux Paint shows a printer dialog (or,
on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed
@@ -985,11 +985,11 @@ altprint=mod
prints without showing a dialog.
+
+## Save Printer Configuration ##
-Save Printer Configuration
-
- printcfg=yes
+ → printcfg=yes ←
(Windows and macOS only)
@@ -1009,11 +1009,11 @@ Save Printer Configuration
"--noprintcfg".
+
+ ## Print Commands ##
- Print Commands
-
- printcommand=COMMAND
+ → printcommand=COMMAND ←
(Linux and Unix only)
@@ -1030,8 +1030,8 @@ Save Printer Configuration
to version 0.9.15, you will need to change it.
-
- altprintcommand=COMMAND
+
+ → altprintcommand=COMMAND ←
(Linux and Unix only)
@@ -1046,11 +1046,11 @@ Save Printer Configuration
kprinter
+
+ ## Paper Size ##
- Paper Size
-
- papersize=PAPERSIZE
+ → papersize=PAPERSIZE ←
(Platforms that use Tux Paint's internal PostScript generator — not
Windows, macOS, BeOS, or Haiku.)
@@ -1067,40 +1067,40 @@ Save Printer Configuration
esheet.
+
+ ### Saving ###
- Saving
+ ## Save Over Earlier Work ##
- Save Over Earlier Work
-
- saveover=yes
+ → saveover=yes ←
This disables the "Save over the old version...?" prompt when saving an
existing file. With this option, the older version will always be
replaced by the new version, automatically.
-
- saveover=new
+
+ → saveover=new ←
This also disables the "Save over the old version...?" prompt when
saving an existing file. This option, however, will always save a new
file, rather than overwrite the older version.
-
- saveover=ask
+
+ → saveover=ask ←
(This option is redundant, since this is the default.) When saving an
existing drawing, you will be first asked whether to save over the
older version or not.
+
+ ## Starting Out ##
- Starting Out
-
- startblank=yes
+ → startblank=yes ←
This causes Tux Paint to display a blank canvas when it first starts
up, rather than loading the last image that was being edited.
@@ -1111,8 +1111,8 @@ Save Printer Configuration
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Places the blank color options in the New dialog at the end, so that
any Starters and/or Templates are shown first.
@@ -1123,30 +1123,30 @@ Save Printer Configuration
command-line option "--newcolorsfirst".
+
+ ## Save and Export Directories ##
- Save and Export Directories
-
- savedir=DIRECTORY
+ → savedir=DIRECTORY ←
Use this option to change where Tux Paint's "saved" directory/folder is
located, which is where Tux Paint saves and opens pictures.
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/username/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/username/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.
@@ -1159,8 +1159,8 @@ Save Printer Configuration
Example: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORY
+
+ → exportdir=DIRECTORY ←
Use this option to change where Tux Paint exports files — single
images, or animated GIF slideshows — for external use.
@@ -1199,11 +1199,11 @@ Save Printer Configuration
Example: exportdir=/home/penguin/TuxPaintExports
+
+ ## More Saving Options ##
- More Saving Options
-
- nosave=yes
+ → nosave=yes ←
This disables Tux Paint's ability to save files (and therefore disables
the on-screen "Save" button). It can be used in situations where the
@@ -1214,8 +1214,8 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--save".
-
- autosave=yes
+
+ → autosave=yes ←
This prevents Tux Paint from asking whether you want to save the
current picture when quitting, and assumes you do.
@@ -1226,8 +1226,8 @@ Save Printer Configuration
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
This reverses the sorting of the Open and Slideshow dialogs, placing
the newest images at the top of the list.
@@ -1238,13 +1238,13 @@ Save Printer Configuration
command-line option "--noreversesort".
+
+ ### Data ###
- Data
+ ## Lockfile ##
- Lockfile
-
- nolockfile=yes
+ → nolockfile=yes ←
By default, Tux Paint uses what's known as a 'lockfile' to prevent it
from being launched more than once in 30 seconds. (This is to avoid
@@ -1266,11 +1266,11 @@ Save Printer Configuration
"--lockfile".
+
+ ## Data Directory ##
- Data Directory
-
- datadir=DIRECTORY
+ → datadir=DIRECTORY ←
Use this option to change where Tux Paint looks for personal data files
(brushes, stamps, starters, templates, and fonts specific to the
@@ -1282,15 +1282,15 @@ Save Printer Configuration
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
/home/username/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/username/Library/Application Support/TuxPaint/
-
+
📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting
or default as for "savedir" to search for data files. As of version
@@ -1302,11 +1302,11 @@ Save Printer Configuration
Example: datadir=/home/johnny/tuxpaint-data/
+
+ ## Color Palette File ##
- Color Palette File
-
- colorfile=FILENAME
+ → colorfile=FILENAME ←
You may override Tux Paint's default color palette by creating a plain
ASCII text file that describes the colors you want, and pointing to
@@ -1333,23 +1333,23 @@ Save Printer Configuration
byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".
+
+ ### Accessibility ###
- Accessibility
+ ## Mouse ##
- Mouse
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
In this mode, instead of clicking, dragging and releasing (e.g., to
draw), you click, move, and click again to end the motion.
+
+ ## Keyboard ##
- Keyboard
-
- keyboard=yes
+ → keyboard=yes ←
This allows the keyboard arrow keys to be used to control the mouse
pointer. (e.g., for mouseless environments, or handicapped/
@@ -1388,18 +1388,18 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--mouse".
+
+ ## Onscreen Keyboard ##
- Onscreen Keyboard
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Presents a clickable on-screen keyboard when using the Text and Label
tools.
-
- onscreen-keyboard-layout=LAYOUTNAME
+
+ → onscreen-keyboard-layout=LAYOUTNAME ←
Selects the initial layout for the on-screen keyboard when using the
Text and Label tools.
@@ -1407,8 +1407,8 @@ Save Printer Configuration
setting both is redundant.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Disables the possibility for changing the layout of the on-screen
keyboard when using the Text and Label tools, useful for simplifying
@@ -1422,191 +1422,191 @@ Save Printer Configuration
by the command-line option "--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Main Device ##
- Main Device
-
- joystick-dev=N
+ → joystick-dev=N ←
Specify which joystick device should be used by Tux Paint. Default
value is 0 (the first joystick).
-
- joystick-slowness=SPEED
+
+ → joystick-slowness=SPEED ←
Sets a delay at each axis motion, allowing to slow the joystick.
Allowed values are from 0 to 500. Default value is 15.
-
- joystick-threshold=THRESHOLD
+
+ → joystick-threshold=THRESHOLD ←
Sets the minimum level of axis motion to start moving the pointer.
Allowed values are from 0 to 32766. Default value is 3200.
-
- joystick-maxsteps=STEPS
+
+ → joystick-maxsteps=STEPS ←
Sets the maximum pixels the pointer will move at once. Allowed values
are from 1 to 7. Default value is 7.
+
+ ## Hat ##
- Hat
-
- joystick-hat-slowness=SPEED
+ → joystick-hat-slowness=SPEED ←
Sets a delay at each automatic motion, allowing to slow the speed of
the hat. Allowed values are from 0 to 500. Default value is 15.
-
- joystick-hat-timeout=MILLISECONDS
+
+ → joystick-hat-timeout=MILLISECONDS ←
Sets the delay after wich the pointer will start moving automatically
if the hat is keeped pushed. Allowed values are from 0 to 3000. Default
value is 1000.
+
+ ## Buttons to Disable ##
- Buttons to Disable
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
A set of joystick button numbers, as seen by SDL, that should be
ignored. Otherwise, unless they are used by one of the "joystick-btn-"
options above, buttons will be seen as a mouse left-click.
+
+## Button Shortcuts ##
-Button Shortcuts
-
- joystick-btn-escape=BUTTON NUMBER
+ → joystick-btn-escape=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be used
to generate a escape event. Useful to dismiss dialogs and quit.
-
- joystick-btn-brush=BUTTON NUMBER
+
+ → joystick-btn-brush=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the brush tool.
-
- joystick-btn-stamp=BUTTON NUMBER
+
+ → joystick-btn-stamp=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the stamp tool.
-
- joystick-btn-lines=BUTTON NUMBER
+
+ → joystick-btn-lines=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the lines tool.
-
- joystick-btn-shapes=BUTTON NUMBER
+
+ → joystick-btn-shapes=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the shapes tool.
-
- joystick-btn-text=BUTTON NUMBER
+
+ → joystick-btn-text=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the text tool.
-
- joystick-btn-label=BUTTON NUMBER
+
+ → joystick-btn-label=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the label tool.
-
- joystick-btn-fill=BUTTON NUMBER
+
+ → joystick-btn-fill=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the fill tool.
-
- joystick-btn-magic=BUTTON NUMBER
+
+ → joystick-btn-magic=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the magic tool.
-
- joystick-btn-undo=BUTTON NUMBER
+
+ → joystick-btn-undo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to invoke the undo tool.
-
- joystick-btn-redo=BUTTON NUMBER
+
+ → joystick-btn-redo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select redo tool.
-
- joystick-btn-eraser=BUTTON NUMBER
+
+ → joystick-btn-eraser=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select eraser tool.
-
- joystick-btn-new=BUTTON NUMBER
+
+ → joystick-btn-new=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for creating a new drawing.
-
- joystick-btn-open=BUTTON NUMBER
+
+ → joystick-btn-open=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for opening an existing drawing.
-
- joystick-btn-save=BUTTON NUMBER
+
+ → joystick-btn-save=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to save the drawing.
-
- joystick-btn-pgsetup=BUTTON NUMBER
+
+ → joystick-btn-pgsetup=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the page setup dialog for printing.
-
- joystick-btn-print=BUTTON NUMBER
+
+ → joystick-btn-print=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to print.
-
+
Overriding System Config. Options
@@ -1631,7 +1631,7 @@ Button Shortcuts
Options may also be issued on the command-line when you go to launch Tux
Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--WIDTHxHEIGHT
--orient=portrait
@@ -1713,13 +1713,14 @@ Button Shortcuts
--reversesort
--lang LANGUAGE
--colorfile FILE
+ ←
These enable or correspond to the configuration file options described
above.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1760,14 +1761,15 @@ Button Shortcuts
--save
--noautosave
--noreversesort
+ ←
These options can be used to override any settings made in the
configuration file. (If the option isn't set in the configuration file
(s), no overriding option is necessary.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1776,52 +1778,52 @@ Button Shortcuts
Linux) — if it exists — will be used.
+
-
- Command-Line Informational Options
+ ### Command-Line Informational Options ###
The following options display some informative text on the screen. Tux
Paint doesn't actually start up and run afterwards, however.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Show brief license information about copying Tux Paint.
-
- --usage
+
+ → --usage ←
Display the list of available command-line options.
-
- --help
+
+ → --help ←
Display brief help on using Tux Paint.
-
- --lang help
+
+ → --lang help ←
Display a list of available languages in Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Display list of attached joysticks available to Tux Paint.
-
+
Choosing a Different Language
@@ -1835,7 +1837,7 @@ Button Shortcuts
Use the option "--lang help" to list the language options available.
- Available Languages
+ ### Available Languages ###
+-------------------------------------------------------------------------+
| | Language | Language | Input Method |
@@ -2136,7 +2138,7 @@ Button Shortcuts
can be used to cycle through the supported input methods while the Text
tool is active.
- Setting Your Environment's Locale
+ ### Setting Your Environment's Locale ###
Changing your locale will affect much of your environment.
@@ -2147,7 +2149,7 @@ Button Shortcuts
If you haven't already set your environment's locale, the following will
briefly explain how:
- Linux/Unix Users
+ ## Linux/Unix Users ##
First, be sure the locale you want to use is enabled by editing the file "/
etc/locale.gen" on your system and then running the program "locale-gen" as
@@ -2175,7 +2177,7 @@ Button Shortcuts
setenv LANG es_ES ; \
tuxpaint
- Windows Users
+ ## Windows Users ##
Tux Paint will recognize the current locale and use the appropriate files
by default. So this section is only for people trying different languages.
@@ -2200,7 +2202,7 @@ Button Shortcuts
+ Edit the value of the parameter "LANG" (create it, if it doesn't
exists).
- Special Fonts
+ ### Special Fonts ###
Some languages require special fonts be installed. These font files (which
are in TrueType format (TTF)), are much too large to include with the Tux
diff --git a/docs/es_ES.UTF-8/PNG.txt b/docs/es_ES.UTF-8/PNG.txt
index cc9f916a4..f406b0cc2 100644
--- a/docs/es_ES.UTF-8/PNG.txt
+++ b/docs/es_ES.UTF-8/PNG.txt
@@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
-How To Make PNGs
+ ### How To Make PNGs ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
-GIMP & Krita
+→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
+
+→ Command-line Tools ←
-Command-line Tools
-
- NetPBM
+ → NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@@ -58,8 +58,8 @@ Command-line Tools
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@@ -68,11 +68,11 @@ Command-line Tools
or to learn more, visit https://jpegclub.org/.
+
-
-
-Proprietary Software for Windows
+
+→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -80,13 +80,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Macintosh Users
+
+→ Macintosh Users ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/es_ES.UTF-8/README.txt b/docs/es_ES.UTF-8/README.txt
index c674765a1..e88be92ba 100644
--- a/docs/es_ES.UTF-8/README.txt
+++ b/docs/es_ES.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
versión 0.9.34
- A simple drawing program for children
+ ## A simple drawing program for children ##
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
- octubre 12, 2024
+ octubre 14, 2024
+-------------------------------------------------+
| Table of Contents |
@@ -44,7 +44,7 @@
I. About Tux Paint
-A. What Is "Tux Paint"?
+ ### A. What Is "Tux Paint"? ###
Tux Paint is a free drawing program designed for young children (kids ages 3
and up). It has a simple, easy-to-use interface, fun sound effects, and an
@@ -52,43 +52,43 @@ encouraging cartoon mascot who helps guide children as they use the program. It
provides a blank canvas and a variety of drawing tools to help your child be
creative.
-B. Objectives
+ ### B. Objectives ###
-Easy and Fun
+→ Easy and Fun ←
Tux Paint is meant to be a simple drawing program for young children. It is
not meant as a general-purpose drawing tool. It is meant to be fun and easy
to use. Sound effects and a cartoon character help let the user know what's
going on, and keeps them entertained. There are also extra-large
cartoon-style mouse pointer shapes.
-
-Extensibility
+
+→ Extensibility ←
Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped
in and pulled out. For example, a teacher can drop in a collection of
animal shapes and ask their students to draw an ecosystem. Each shape can
have a sound which is played, and textual facts which are displayed, when
the child selects the shape.
-
-Portability
+
+→ Portability ←
Tux Paint is portable among various computer platforms: Windows, Macintosh,
Linux, etc. The interface looks the same among them all. Tux Paint runs
suitably well on older systems, and can be built to run better on slow
systems.
-
-Simplicity
+
+→ Simplicity ←
There is no direct access to the computer's underlying intricacies. The
current image is kept when the program quits, and reappears when it is
restarted. Saving images requires no need to create filenames or use the
keyboard. Opening an image is done by selecting it from a collection of
thumbnails. Access to other files on the computer is restricted.
-
-Accessibility
+
+→ Accessibility ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
+
-
-C. License
+ ### C. License ###
Tux Paint is an Open Source project, Free Software released under the GNU
General Public License (GPL). It is free, and the 'source code' behind the
@@ -97,62 +97,76 @@ parts of the program in their own GPL'd software.)
See COPYING.txt for the full text of the GPL license.
-D. What's New in Tux Paint version 0.9.34?
+ ### D. What's New in Tux Paint version 0.9.34? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
See CHANGES.txt for the complete list of changes.
II. Using Tux Paint
-A. Launching Tux Paint
+ ### A. Launching Tux Paint ###
-1. Linux/Unix Users
+## 1. Linux/Unix Users ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@@ -163,7 +177,7 @@ Alternatively, you can run the following command at a shell prompt (e.g., "$"):
If any errors occur, they will be displayed on the terminal (to STDERR).
-2. Windows Users
+## 2. Windows Users ##
[Tux Paint Icon]
Tux Paint
@@ -187,13 +201,14 @@ installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
-3. macOS Users
+## 3. macOS Users ##
Simply double-click the "Tux Paint" icon.
[Title screen]
+
-B. Title Screen
+ ### B. Title Screen ###
When Tux Paint first loads, a title/credits screen will appear.
@@ -201,20 +216,22 @@ Once loading is complete, press a key or click or tap in the Tux Paint window
to continue. (Or, after about 5 seconds, the title screen will go away
automatically.)
-C. Main Screen
+ ### C. Main Screen ###
The main screen is divided into the following sections:
[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser,
New, Open, Save, Print, Quit]
-Left Side: Toolbar
+
+→ Left Side: Toolbar ←
The toolbar contains the drawing and editing controls.
-
+
[Canvas]
-Middle: Drawing Canvas
+
+→ Middle: Drawing Canvas ←
The largest part of the screen, in the center, is the drawing canvas. This
is, obviously, where you draw!
@@ -225,9 +242,10 @@ Middle: Drawing Canvas
more details.
-
+
[Selectors - Brushes, Letters, Shapes, Stamps]
-Right Side: Selector
+
+→ Right Side: Selector ←
Depending on the current tool, the selector shows different things. e.g.,
when the Paint Brush or Line tool is selected, it shows the various brushes
@@ -236,10 +254,11 @@ Right Side: Selector
various fonts.
-
+
[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue,
Purple, Brown, Grey]
-Lower: Colors
+
+→ Lower: Colors ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@@ -295,23 +314,24 @@ Lower: Colors
documentation.
-
+
(Example tip: 'Pick a shape. Click to pick the center, drag, then let go
when it is the size you want. Move around to rotate it, and click to draw
it.')
-Bottom: Help Area
+
+→ Bottom: Help Area ←
At the very bottom of the screen, Tux, the Linux Penguin, provides tips and
other information while you use Tux Paint.
+
+ ### D. Available Tools ###
-D. Available Tools
+## 1. Drawing Tools ##
-1. Drawing Tools
-
-a. "Paint" Tool (Brush)
+a. "Paint" Tool (Brush) ←
The Paint Brush tool lets you draw freehand, using various brushes (chosen
in the Selector on the right) and colors (chosen in the Color palette
@@ -353,8 +373,8 @@ a. "Paint" Tool (Brush)
the brush spacing controls. See the "Options" documentation.
-
-b."Stamp" Tool (Rubber Stamps)
+
+b."Stamp" Tool (Rubber Stamps) ←
The Stamp tool is like a set of rubber stamps or stickers. It lets you
paste pre-drawn or photographic images (like a picture of a horse, or a
@@ -364,12 +384,12 @@ b."Stamp" Tool (Rubber Stamps)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
- Stamp Categories
+ → Stamp Categories ←
There can be numerous categories of stamps (e.g., animals, plants,
outer space, vehicles, people, etc.). Use the Left and Right arrows
near the bottom of the Selector to cycle through the collections.
-
- Stamp Rotation
+
+ → Stamp Rotation ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@@ -386,8 +406,8 @@ b."Stamp" Tool (Rubber Stamps)
0.9.29.
-
- Stamp Controls
+
+ → Stamp Controls ←
Prior to 'stamping' an image onto your drawing, various effects can
sometimes be applied (depending on the stamp):
@@ -406,8 +426,8 @@ b."Stamp" Tool (Rubber Stamps)
Options" documentation.
-
- Stamp Sounds
+
+ → Stamp Sounds ←
Different stamps can have different sound effects and/or descriptive
(spoken) sounds. Buttons in the Help Area at the lower left (near Tux,
@@ -415,11 +435,11 @@ b."Stamp" Tool (Rubber Stamps)
descriptive sounds for the currently-selected stamp.
+
-
-
-c."Lines" Tool
+
+c."Lines" Tool ←
This tool lets you draw straight lines using the various brushes and colors
you normally use with the Paint Brush.
@@ -444,8 +464,8 @@ c."Lines" Tool
to learn more.
-
-d."Shapes" Tool
+
+d."Shapes" Tool ←
This tool lets you draw some simple filled, and un-filled shapes.
@@ -453,15 +473,15 @@ d."Shapes" Tool
Use the options at the bottom right to choose the shape tool's behavior:
- Shapes from center
+ → Shapes from center ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
-
- Shapes from corner
+
+ → Shapes from corner ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@@ -469,7 +489,7 @@ d."Shapes" Tool
📜 This option was added starting with Tux Paint version 0.9.25.
-
+
⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols"
option), the controls will not be presented, and the "shapes from center"
@@ -487,7 +507,7 @@ d."Shapes" Tool
Let go of the mouse when you're done stretching.
- Normal Shapes Mode
+ → Normal Shapes Mode ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@@ -497,8 +517,8 @@ d."Shapes" Tool
color.
-
- Simple Shapes Mode
+
+ → Simple Shapes Mode ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@@ -507,11 +527,11 @@ d."Shapes" Tool
("simpleshapes") option.
+
-
-
-e."Text" and "Label" Tools
+
+e."Text" and "Label" Tools ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@@ -532,7 +552,7 @@ e."Text" and "Label" Tools
causes the current line of text to move to that location (where you can
continue editing it).
- "Text" versus "Label"
+ → "Text" versus "Label" ←
The Text tool is the original text-entry tool in Tux Paint. Text
entered using this tool can't be modified or moved later, since it
@@ -567,8 +587,8 @@ e."Text" and "Label" Tools
option).
-
- International Character Input
+
+ → International Character Input ←
Tux Paint allows inputting characters in different languages. Most
Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some
@@ -594,8 +614,8 @@ e."Text" and "Label" Tools
trying to type.
-
- On-screen Keyboard
+
+ → On-screen Keyboard ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@@ -605,11 +625,11 @@ e."Text" and "Label" Tools
information.
+
-
-
-f."Fill" Tool
+
+f."Fill" Tool ←
The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a
color of your choice. Three fill options are offered:
@@ -632,8 +652,8 @@ f."Fill" Tool
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
-
-g."Magic" Tool (Special Effects)
+
+g."Magic" Tool (Special Effects) ←
The Magic tool is actually a set of special tools. Select one of the
'magic' effects from the selector on the right. Then, depending on the
@@ -683,8 +703,8 @@ g."Magic" Tool (Special Effects)
one large list. See the "Options" documentation.
-
-h."Eraser" Tool
+
+h."Eraser" Tool ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -716,11 +736,11 @@ h."Eraser" Tool
currently-selected tool.
+
+## 2. Other Controls ##
-2. Other Controls
-
-a."Undo" and "Redo" Commands
+a."Undo" and "Redo" Commands ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@@ -736,8 +756,8 @@ a."Undo" and "Redo" Commands
⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo.
-
-b."New" Command
+
+b."New" Command ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -751,14 +771,14 @@ b."New" Command
⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a
new drawing.
- Special Solid Background Color Choices
+ → Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Main Screen > Lower: Colors > Special color options for
details.
-
- 'Starter' & Template Images
+
+ 'Starter' & Template Images ←
o 'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color in,
and the black outline remains intact — or like a 3D photograph,
@@ -788,8 +808,8 @@ b."New" Command
within Tux Paint, from the 'Open' dialog. See "Open", below.
-
- Erasing Exported Template Images
+
+ → Erasing Exported Template Images ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@@ -805,14 +825,14 @@ b."New" Command
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
-
+
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
-
-c."Open" Command
+
+c."Open" Command ←
This shows you a list of all of the pictures you've saved. If there are
more than can fit on the screen, use the up and down arrows at the top and
@@ -864,8 +884,8 @@ c."Open" Command
the 'Open' dialog.
-
-d."Save" Command
+
+d."Save" Command ←
This saves your current picture.
@@ -885,8 +905,8 @@ d."Save" Command
⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save.
-
-e."Print" Command
+
+e."Print" Command ←
Click this button and your picture will be printed!
@@ -895,7 +915,7 @@ e."Print" Command
this may not work if you're running Tux Paint in fullscreen mode. See
below.
- Disabling Printing
+ → Disabling Printing ←
The "noprint" option can be set, which will disable Tux Paint's 'Print'
button.
@@ -903,8 +923,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Restricting Printing
+
+ → Restricting Printing ←
The "printdelay" option can be set, which will only allow occasional
printing — once every so many seconds, as configured by you.
@@ -915,8 +935,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printing Commands
+
+ → Printing Commands ←
(Linux and Unix only)
@@ -942,8 +962,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Settings
+
+ → Printer Settings ←
(Windows and macOS)
@@ -965,8 +985,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Dialog Options
+
+ → Printer Dialog Options ←
By default, Tux Paint only shows the printer dialog (or, on Linux/Unix,
runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the
@@ -981,17 +1001,17 @@ e."Print" Command
⚙ See the "Options" documentation.
+
-
-
-f."Slides" Command (under "Open")
+
+f."Slides" Command (under "Open") ←
The 'Slides' button is available in the 'Open' dialog. It can be used to
play a simple animation within Tux Paint, or a slideshow of pictures. It
can also export an animated GIF based on the chosen images.
- Chosing pictures
+ → Chosing pictures ←
When you enter the 'Slides' section of Tux Paint, it displays a list of
your saved files, just like the 'Open' dialog.
@@ -1005,8 +1025,8 @@ f."Slides" Command (under "Open")
list.
-
- Set playback speed
+
+ → Set playback speed ←
A sliding scale at the lower left of the screen (next to the 'Play'
button) can be used to adjust the speed of the slideshow or animated
@@ -1019,8 +1039,8 @@ f."Slides" Command (under "Open")
does not apply to an exported animated GIF.)
-
- Playback in Tux Paint
+
+ → Playback in Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@@ -1036,8 +1056,8 @@ f."Slides" Command (under "Open")
the slideshow and return to the slideshow image selection screen.
-
- Exporting an animated GIF
+
+ → Exporting an animated GIF ←
Click the 'GIF Export' button near the lower right to have Tux Paint
generate an animated GIF file based on the selected images.
@@ -1051,14 +1071,14 @@ f."Slides" Command (under "Open")
return you to the 'Slideshow' dialog.
-
+
Click 'Back' in the slideshow image selection screen to return to the
'Open' dialog.
-
-g."Quit" Command
+
+g."Quit" Command ←
Clicking the 'Quit' button, closing the Tux Paint window, or pushing the
[Escape] key will quit Tux Paint.
@@ -1085,8 +1105,8 @@ g."Quit" Command
⚙ See the "Options" documentation.
-
-h.Sound Muting
+
+h.Sound Muting ←
There is no on-screen control button at this time, but by using the [Alt] +
[S] keyboard sequence, sound effects can be disabled and re-enabled (muted
@@ -1099,11 +1119,11 @@ h.Sound Muting
⚙ See the "Options" documentation.
+
+ ### E. Controlling Tux Paint ###
-E. Controlling Tux Paint
-
-1. Using a Mouse or Trackball
+## 1. Using a Mouse or Trackball ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@@ -1119,7 +1139,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
-a. Scrolling
+# a. Scrolling #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@@ -1132,7 +1152,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
-b. Mouse Accessibility
+# b. Mouse Accessibility #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@@ -1145,7 +1165,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
-2. Using a Tablet or Touchscreen
+## 2. Using a Tablet or Touchscreen ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@@ -1157,7 +1177,7 @@ Some examples:
* Eraser tip
* Multi-touch gestures
-3. Using a Joystick-like Device
+## 3. Using a Joystick-like Device ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@@ -1171,7 +1191,7 @@ to different Tux Paint controls (e.g., acting as the [Escape] key, switching to
the Paint tool, invoking Undo and Redo operations, etc.). See the Options
documentation for more details.
-4. Using the Keyboard
+## 4. Using the Keyboard ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@@ -1180,7 +1200,7 @@ documentation for more details.
III. Loading Other Pictures into Tux Paint
-A. Overview
+ ### A. Overview ###
Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So
what do you do if you want to load some other drawinng or even a photograph
@@ -1190,29 +1210,29 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Note: It is also from this folder that you can copy or open pictures drawn in
Tux Paint using other applications, though the 'Export' option from Tux Paint's
'Open' dialog can be used to copy them to a location that's easier and safer to
access.
-B. Using the import script, "tuxpaint-import"
+ ### B. Using the import script, "tuxpaint-import" ###
Linux and Unix users can use the "tuxpaint-import" shell script which gets
installed when you install Tux Paint. It uses some NetPBM tools to convert the
@@ -1243,7 +1263,7 @@ following two lines are output from the program while it's working.
Now you can load Tux Paint, and a version of that original picture will be
available under the 'Open' dialog. Just double-click its icon!
-C. Importing Pictures Manually
+ ### C. Importing Pictures Manually ###
Windows, macOS, and Haiku users who wish to import arbitrary images into Tux
Paint must do so via a manual process.
@@ -1261,7 +1281,7 @@ Paint's canvas size. This size depends on the size of the Tux Paint window, or
resolution at which Tux Paint is run, if in fullscreen. (Note: The default
resolution is 800x600.) See "Calculating Image Dimensions", below.
-1. Naming the File
+## 1. Naming the File ##
Save the picture in PNG format. It is highly recommended that you name the
filename using the current date and time, since that's the convention Tux Paint
@@ -1280,7 +1300,7 @@ Example: "20210731110500.png", for July 31, 2021 at 11:05am.
Place this PNG file in your Tux Paint "saved" directory/folder. (See above.)
-2. Calculating Image Dimensions
+## 2. Calculating Image Dimensions ##
This part of the documentation needs to be rewritten, since the new
"buttonsize" option was added. For now, try drawing and saving an image within
@@ -1293,7 +1313,7 @@ IV.Further Reading
Other documentation included with Tux Paint (found in the "docs" folder/
directory) includes:
-Using Tux Paint:
+→ Using Tux Paint: ←
+ OPTIONS.html
Detailed instructions on command-line and configuration-file options,
for those who don't want to use the Tux Paint Config. tool to manage
@@ -1304,8 +1324,8 @@ Using Tux Paint:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-How to extend Tux Paint:
+
+→ How to extend Tux Paint: ←
+ EXTENDING.html
Detailed instructions on extending Tux Paint: creating brushes, stamps,
starters, and templates; adding fonts; and creating new on-screen
@@ -1316,8 +1336,8 @@ How to extend Tux Paint:
+ SVG.html
Notes on creating SVG format vector images for use in Tux Paint.
-
-Technical information:
+
+→ Technical information: ←
+ INSTALL.html
Instructions for compiling and installing Tux Paint, when applicable.
+ SIGNALS.html
@@ -1325,8 +1345,8 @@ Technical information:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
-
-Development history and license:
+
+→ Development history and license: ←
+ AUTHORS.txt
List of authors and contributors.
+ CHANGES.txt
@@ -1334,7 +1354,7 @@ Development history and license:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
-
+
V.How to Get Help
diff --git a/docs/es_ES.UTF-8/SIGNALS.txt b/docs/es_ES.UTF-8/SIGNALS.txt
index 28bbe0a54..c61944b52 100644
--- a/docs/es_ES.UTF-8/SIGNALS.txt
+++ b/docs/es_ES.UTF-8/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
-SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
+→ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@@ -32,8 +32,8 @@ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
the [Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/es_ES.UTF-8/SVG.txt b/docs/es_ES.UTF-8/SVG.txt
index 8fb06eba6..ae610dda8 100644
--- a/docs/es_ES.UTF-8/SVG.txt
+++ b/docs/es_ES.UTF-8/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Open Source
+→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Proprietary
+
+→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/es_ES.UTF-8/html/EXTENDING.html b/docs/es_ES.UTF-8/html/EXTENDING.html
index 66431fde3..cb555a4d2 100644
--- a/docs/es_ES.UTF-8/html/EXTENDING.html
+++ b/docs/es_ES.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the width of the canvas.
@@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the height of the canvas.
@@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
+
Focusing on the top of a starter image stretched to fit the width of the canvas.
@@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
+
Focusing on the bottom of a starter image stretched to fit the width of the canvas.
@@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
+
Focusing on the right of a starter image stretched to fit the height of the canvas.
diff --git a/docs/es_ES.UTF-8/html/README.html b/docs/es_ES.UTF-8/html/README.html
index ed888cc47..56e2653c5 100644
--- a/docs/es_ES.UTF-8/html/README.html
+++ b/docs/es_ES.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- octubre 12, 2024
+ octubre 14, 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- New brushes
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Title screen]">
+
B. Title Screen
@@ -412,6 +413,7 @@
height="254"
alt=
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]">
+
-
Left Side: Toolbar
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Canvas]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[Selectors - Brushes, Letters, Shapes, Stamps]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
+
-
@@ -486,13 +491,14 @@
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.)
-
+
+

+
-
On the far right are three special color options:
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Example tip: 'Pick a shape. Click to pick the center, drag, then let go when it is the size you want. Move around to rotate it, and click to draw it.')">
+
-
diff --git a/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt b/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt
index 4ac010147..69e287d21 100644
--- a/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Tux Paint 0.9.34 Quickstart Guide
-Tools (Drawing)
+ ### Tools (Drawing) ###
-🖌Paint
+## 🖌Paint ##
* Choose a brush on the right.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@@ -10,7 +10,7 @@ Tools (Drawing)
* Choose a color (see "Colors").
* Click/tap and drag in the canvas to paint.
-⌧Stamps
+## ⌧Stamps ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right.
@@ -27,12 +27,12 @@ Tools (Drawing)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
-⚟Lines
+## ⚟Lines ##
* (See Paint)
* Click/tap and drag to draw a line.
-⭓Shapes
+## ⭓Shapes ##
* Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a corner
@@ -40,7 +40,7 @@ Tools (Drawing)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
-🄰Text
+## 🄰Text ##
* Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@@ -60,7 +60,7 @@ Tools (Drawing)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
-🅰Label
+## 🅰Label ##
* (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@@ -74,7 +74,7 @@ Tools (Drawing)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
-🪣Fill
+## 🪣Fill ##
* Choose a fill mode on the right.
* Choose a color (see "Colors").
@@ -90,7 +90,7 @@ Tools (Drawing)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
-🪄Magic
+## 🪄Magic ##
* Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@@ -101,26 +101,26 @@ Tools (Drawing)
bottom right.
* Some magic tools allow you to choose their color.
-🖓Undo
+## 🖓Undo ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
-🖒Redo
+## 🖒Redo ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
-◪Eraser
+## ◪Eraser ##
* Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
-Tools (Controls)
+ ### Tools (Controls) ###
-🗏New
+## 🗏New ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@@ -131,7 +131,7 @@ Tools (Controls)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
-🕮⮫Open
+## 🕮⮫Open ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@@ -150,7 +150,7 @@ Tools (Controls)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
-🕮⮪Save
+## 🕮⮪Save ##
* Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite the
@@ -158,19 +158,19 @@ Tools (Controls)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
-🖶Print
+## 🖶Print ##
* Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Quit
+## 🗙Quit ##
* Click/tap to quit Tux Paint.
* Shortcut: [Escape]
-Colors
+ ### Colors ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@@ -194,7 +194,7 @@ Colors
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
-Shortcuts while drawing:
+ ### Shortcuts while drawing: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access
diff --git a/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index 63fbd4f78..8ecb38fa9 100644
--- a/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+----------------------------------------------------+
-------------------------------------------------------------------------------
-À propos de ce 'guide pratique'
+ ### À propos de ce 'guide pratique' ###
Ce 'guide pratique' suppose que vous vouliez créer un excellent tampon pour
Tux Paint, au format bitmap PNG, à partir d'une image JPEG (par ex. une
@@ -34,9 +34,9 @@
-------------------------------------------------------------------------------
-Le choix de l'image est crucial
+ ### Le choix de l'image est crucial ###
- Licence
+ ## Licence ##
Si vous voulez présenter une oeuvre aux développeurs de Tux Paint
destinée à être incluse dans le projet officiel, ou si vous voulez
@@ -59,7 +59,7 @@ Le choix de l'image est crucial
Pour un usage personnel, toute image que vous pouvez légalement
modifier et utiliser pour vous-même devrait convenir.
- Taille et orientation de l'image
+ ## Taille et orientation de l'image ##
Vous aurez besoin d'une image ayant une bonne orientation. La
perspective est notre ennemie. Les images montrant un objet à partir
@@ -91,7 +91,7 @@ Le choix de l'image est crucial
-------------------------------------------------------------------------------
-Préparez l'image
+ ### Préparez l'image ###
Tout d'abord, ne re-sauvegardez pas une image au format JPEG. Cela induit
une perte de qualité. Il existe un outil spécial appelé jpegtran qui vous
@@ -132,7 +132,7 @@ Préparez l'image
-------------------------------------------------------------------------------
-Préparez le masque
+ ### Préparez le masque ###
Prenez l'habitude de faire un [Control]-clic et un [Alt]-clic sur les
images-vignettes dans la boîte de dialogue des calques. Vous devez le faire
@@ -197,7 +197,7 @@ Préparez le masque
-------------------------------------------------------------------------------
-Remplacer la frange et les pixels indésirables
+ ### Remplacer la frange et les pixels indésirables ###
Toujours en regardant le masque, sélectionnez par couleur. Choisissez le
noir. Réduisez la sélection de plusieurs pixels, en veillant à NE PAS
@@ -268,7 +268,7 @@ Remplacer la frange et les pixels indésirables
-------------------------------------------------------------------------------
-Sauvegarder l'image pour Tux Paint
+ ### Sauvegarder l'image pour Tux Paint ###
Il est très facile de gâcher votre travail, lui qui vous a demandé beaucoup
d'efforts. Les éditeurs d'images peuvent détruire silencieusement les
@@ -281,7 +281,7 @@ Sauvegarder l'image pour Tux Paint
de la place (et cacher vos erreurs), vous êtes presque certain de détruire
toutes les zones à 0% opacité. Alors, voici une meilleure façon...
- Une façon sûre pour sauvegarder
+ ## Une façon sûre pour sauvegarder ##
Faites glisser le masque de la boîte de dialogue des calques vers la
partie inutilisée de la barre d'outils (juste après le dernier outil de
diff --git a/docs/fr_FR.UTF-8/ENVVARS.txt b/docs/fr_FR.UTF-8/ENVVARS.txt
index 762016a17..4c742bd81 100644
--- a/docs/fr_FR.UTF-8/ENVVARS.txt
+++ b/docs/fr_FR.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint interprète plusieurs variables d'environnement, soit directement,
soit indirectement par le biais des bibliothèques qu'il utilise.
-Variables d'environnement relatives au stockage
+ ### Variables d'environnement relatives au stockage ###
-HOME
+→ HOME ←
Spécifie le répertoire personnel de l'utilisateur, qui sert à accueillir de
nombreux autres fichiers ou répertoires. Dans quelques cas, il sert de
@@ -32,8 +32,8 @@ HOME
tampons, pinceaux, etc, —) (par opposition aux fichiers accessibles à
tout le monde)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group)
sont appliqués, c'est l'endroit où se trouvent les fichiers de
@@ -46,8 +46,8 @@ XDG_CONFIG_HOME
"$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group)
sont appliqués, c'est l'endroit où se trouvent les fichiers de données de
@@ -58,19 +58,19 @@ XDG_DATA_HOME
plutôt que déplacées quelque part.
-
-TEMP
+
+→ TEMP ←
Spécifie l'endroit où les fichiers temporaires peuvent être créés. Tux
Paint l'utilise seulement sous Microsoft Windows. Utilise "userdata" si non
spécifié.
-Variables d'environnement relatives aux langues
+ ### Variables d'environnement relatives aux langues ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -79,24 +79,24 @@ LC_MESSAGES
and finally "LANG".
+
-
-Variables d'environnement en rapport avec l'affichage
+ ### Variables d'environnement en rapport avec l'affichage ###
Ce qui suit donne quelques variables d'environnement supportées par Simple
DirectMedia Layer (libSDL) — que Tux Paint utilise pour l'affichage des
dessins, pour jouer des sons et traiter les saisies de la souris, du clavier et
du joystick — et qui peuvent être utiles aux utilisateurs de Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Spécifie si Tux Paint autorise l'utilisation d'un économiseur d'écran. Peut
être mis à '1' (vrai) par Tux Paint lui-même avec l'option en ligne de
commande "--allowscreensaver" ou dans son fichier de configuration.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Demande où positionner la fenêntre de Tux Paint, ce qui peut être utilisé
pour spécifier où mettre Tux Paint en plein écran en configuration
@@ -106,5 +106,5 @@ SDL_VIDEO_WINDOW_POS
"center" (ce qui signifie "centré").
-
+
diff --git a/docs/fr_FR.UTF-8/EXTENDING.txt b/docs/fr_FR.UTF-8/EXTENDING.txt
index 586fd1e1a..449e74763 100644
--- a/docs/fr_FR.UTF-8/EXTENDING.txt
+++ b/docs/fr_FR.UTF-8/EXTENDING.txt
@@ -46,12 +46,12 @@ prennent effet.
Où vont les fichiers
-Fichiers standards
+ ### Fichiers standards ###
Tux Paint recherche ses différents fichiers de données dans son répertoire
'data'.
-Linux et Unix
+→ Linux et Unix ←
L'emplacement de ce répertoire dépend de la valeur définie pour
"DATA_PREFIX" lors de la construction de Tux Paint . Voir INSTALL. pour
@@ -66,8 +66,8 @@ Linux et Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint recherche un répertoire appelé 'data' dans le même répertoire que
l'exécutable. C'est le répertoire que l'installateur a utilisé lors de
@@ -76,8 +76,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint stocke ses fichiers de données dans l'icône de l'application "Tux
Paint" (qui est en fait un type spécial de dossier sur macOS & Mac OS X
@@ -114,14 +114,14 @@ macOS
les utilisateurs de Tux Paint .
+
-
-Fichiers personnels
+ ### Fichiers personnels ###
Vous pouvez également créer des pinceaux, des images de démarrage, des modèles
et des polices dans votre propre répertoire où Tux Paint les retrouvera.
-Windows
+→ Windows ←
Votre dossier personnel Tux Paint est stocké dans votre dossier
"Application Data". Par exemple, sur un Windows plus récent :
@@ -129,8 +129,8 @@ Windows
C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -138,8 +138,8 @@ macOS
/Users/nom d'utilisateur/Library/Application Support/TuxPaint/
-
-Linux et Unix
+
+→ Linux et Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/nom d'utilisateur/.tuxpaint/".
@@ -147,7 +147,7 @@ Linux et Unix
N'oubliez pas le point (" .") avant le "tuxpaint" !
-
+
Pour ajouter des pinceaux, des tampons, des 'images de démarrage',des modèles
et des polices créez des sous-répertoires dans votre répertoire personnel Tux
@@ -170,7 +170,7 @@ Les pixels en niveaux de gris dans le pinceau PNG seront dessinés en utilisant
la couleur actuellement sélectionnée dans Tux Paint . Les pixels de couleur
seront teintés.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -180,7 +180,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Support pour la régionalisation
+→ Support pour la régionalisation ←
Des lignes supplémentaires peuvent être ajoutées au fichier texte pour
fournir des traductions de la description, à afficher lorsque Tux Paint
@@ -201,17 +201,17 @@ Support pour la régionalisation
Paint est en cours d'exécution, le texte anglais américain sera utilisé.
-
-Utilisateurs de Windows
+
+→ Utilisateurs de Windows ←
Utilisez NotePad ou WordPad pour modifier / créer ces fichiers.
Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont
une extension ".txt" à la fin du nom de fichier.
+
-
-Options de pinceau
+ ### Options de pinceau ###
Outre une une forme graphique, les pinceaux peuvent également recevoir d'autres
attributs. Pour ce faire, vous devez créer un «fichier de données» pour brosse.
@@ -223,7 +223,7 @@ Le fichier porte le même nom que l'image PNG , mais une extension ".dat". (par
exemple, le fichier de données "brosse.png" est le fichier texte "brosse.dat"
qui se trouve dans le même répertoire.)
-Espacement des pinceaux
+→ Espacement des pinceaux ←
Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais spécifier
l'espacement des coups de pinceaux (c'est-à-dire la fréquence à laquelle
@@ -235,8 +235,8 @@ Espacement des pinceaux
le nombre est bas, plus le pinceau est dessiné souvent.)
-
-Pinceaux animés
+
+→ Pinceaux animés ←
Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des
pinceaux animés. Au fur et à mesure que le pinceau est utilisé, chaque
@@ -253,8 +253,8 @@ Pinceaux animés
random" au fichier de données du pinceau.
-
-Pinceaux directionnels
+
+→ Pinceaux directionnels ←
Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des
pinceaux orientables. Au fur et à mesure que le pinceau est utilisé,
@@ -270,8 +270,8 @@ Pinceaux directionnels
brosse.
-
-Pinceaux tournants
+
+→ Pinceaux tournants ←
Depuis la version 0.9.27 de Tux Paint , vous pouvez désormais créer des
pinceaux tournants. Au fur et à mesure que le pinceau est utilisé, il
@@ -280,8 +280,8 @@ Pinceaux tournants
Ajoute une ligne contenant le mot "rotate" au fichier de données brosse.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -289,8 +289,8 @@ Chaotic Brushes
Ajoute une ligne contenant le mot "chaotic" au fichier de données brosse.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -304,7 +304,7 @@ Animated Directional, Rotating, or Chaotic Brushes
formes de direction pour la première image, par exemple).
-
+
Placez les PNG de l'image du pinceau (et tous les fichiers texte de données)
dans le répertoire "brushes".
@@ -321,7 +321,7 @@ utile de créer des sous-sous-répertoires pour organiser les tampons. (Par
exemple, vous pouvez avoir un dossier "holidays" avec "halloween" et
"christmas" comme sous-dossiers.)
-Images des tampons
+ ### Images des tampons ###
Les tampons en caoutchouc dans Tux Paint peuvent être constitués d'un certain
nombre de fichiers séparés. Le seul fichier requis est, bien entendu, l'image
@@ -356,7 +356,7 @@ documentation " SVG" pour plus d'informations et de conseils.
créer des images PNG qui seront parfaitement mises à l'échelle lorsqu'elles
seront utilisées comme tampons dans Tux Paint .
-Texte de description des tampons
+ ### Texte de description des tampons ###
Tux Paint affichera un texte descriptif quand un tampon est sélectionné. Le
texte est mis dans fichier (avec texte simple) ayant le même nom que le PNG ou
@@ -366,7 +366,7 @@ description est "stamp.txt" est placée dans le même répertoire).
La première ligne du fichier texte sera utilisée comme description de l'image
du tampon, en anglais américain. Il doit être encodé en UTF-8.
-Support pour la régionalisation
+→ Support pour la régionalisation ←
Des lignes supplémentaires peuvent être ajoutées au fichier texte pour
fournir des traductions de la description, à afficher lorsque Tux Paint
@@ -387,17 +387,17 @@ Support pour la régionalisation
Paint est en cours d'exécution, le texte anglais américain sera utilisé.
-
-Utilisateurs de Windows
+
+→ Utilisateurs de Windows ←
Utilisez NotePad ou WordPad pour modifier / créer ces fichiers.
Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont
une extension ".txt" à la fin du nom de fichier.
+
-
-Effets sonores des tampons
+ ### Effets sonores des tampons ###
Tux Paint peut jouer un effet sonore quand un tampon est choisi. Par exemple,
le son d'un canard faisant coin-coin, ou un bref morceau de musique quand un
@@ -406,7 +406,7 @@ OGG Vorbis (".ogg"), et porter le même nom que l'image PNG ou SVG.( par ex.,
l'effet sonore "stamp.ogg" est le son du fichier "stamp.svg" qui est dans le
même répertoire).
-Support pour la régionalisation
+→ Support pour la régionalisation ←
Pour les sons de différentes locales (par exemple, si le son est quelqu'un
qui dit un mot, et que vous voulez des versions traduites du mot prononcé),
@@ -422,12 +422,12 @@ Support pour la régionalisation
charger le fichier son «par défaut». (par exemple, "stamp.wav")
-
+
💡 Remarque : Pensez à utiliser les descriptions sonores; voir 'Son descriptif
du tampon' ci-dessous.
-Son descriptif du tampon
+ ### Son descriptif du tampon ###
Tux Paint peut également émettre une description sonore quand on choisit un
tampon. Par ex., une personne disant le mot "canard" quand on choisit un
@@ -437,7 +437,7 @@ le même nom que l'image PNG ou SVG, avec "_desc" à la fin (par ex., le son
descritid de "stamp.svg" est le fichier son "stamp_desc.ogg" dans le même
répertoire).
-Support pour la régionalisation
+→ Support pour la régionalisation ←
Pour les descriptions sonores dans différentes langues, créez également des
fichiers WAV ou OGG avec à la fois "_desc" et le libellé des paramètres
@@ -453,9 +453,9 @@ Support pour la régionalisation
de charger le fichier son «par défaut». (par exemple, "stamp_desc.wav")
+
-
-Options des tampons
+ ### Options des tampons ###
Outre une une forme graphique, un texte de description, un effet sonore et une
description orale, les tampons peuvent également recevoir d'autres attributs.
@@ -468,11 +468,11 @@ Le fichier porte le même nom que l'image PNG ou SVG , mais une extension
".dat". (par exemple, le fichier de données "stamp.png" est le fichier texte
"stamp.dat" qui se trouve dans le même répertoire.)
-Tampons colorés
+→ Tampons colorés ←
Les tampons peuvent être soit "colorables" soit '"teintables"
- Colorable
+ → Colorable ←
Les tampons "colorables" fonctionnent comme des pinceaux - vous
choisissez le tampon pour obtenir la forme, puis choisissez la couleur
@@ -486,8 +486,8 @@ Tampons colorés
tampon.
-
- Teinté
+
+ → Teinté ←
Les tampons «teintés» sont similaires aux tampons «colorables», sauf
que les détails de l'image originale sont conservés. (Pour le dire
@@ -498,14 +498,14 @@ Tampons colorés
tampon.
-
- Options de teinture :
+
+ → Options de teinture : ←
En fonction du contenu de votre tampon, vous souhaiterez peut-être que
Tux Paint utilise l'une des nombreuses méthodes pour le teinter.
Ajoutez l'une des lignes suivantes au fichier de données du tampon :
- Coloriage normal — "tinter=normal" (par défaut)
+ → Coloriage normal — "tinter=normal" (par défaut) ←
C'est le mode normal de teinture. Tout d'abord, la teinte primaire
du tampon est déterminée. (Par exemple, l'image d'une fleur avec sa
tige aura la couleur des pétales considérée comme teinte primaire
@@ -516,28 +516,28 @@ Tampons colorés
ce sera dans une étendue de 50 %, puis on réessaie). Tout ce qui
est à l'intérieur de l'étendue de 50 % (par ex. ±27°) est modifié
pour avoir la teinte de la couleur choisie par l'utilisateur.
-
- Coloriage étroit — "tinter=narrow"
+
+ → Coloriage étroit — "tinter=narrow" ←
C'est comme l'option "normal" décrite plus haut, mais avec une
étendue de teinte plus faible de ±6°. Tout ce qui est trouvé dans
l'étendue (par ex. ±9°) est teinté. Si une trop grande partie de
vitre image est teintée, essayez cette option.
-
- Coloriage 'toutes tonalités' — "tinter=anyhue"
+
+ → Coloriage 'toutes tonalités' — "tinter=anyhue" ←
Cela rempappe toutes les teintes du tampon. C'est pareil que les
options "anyhue" et "narrow" décrites auparavant, mais l'étendu de
teinte est ±180°.
-
- Coloriage vectoriel — "tinter=vector"
+
+ → Coloriage vectoriel — "tinter=vector" ←
Cela mappe «noir à blanc» à «noir à destination».
+
+
-
-
-
-Tampons inaltérables
+
+→ Tampons inaltérables ←
Par défaut, un tampon peut être retourné, affiché comme une image miroir,
ou les deux. Cela se fait à l'aide des boutons de commande sous le
@@ -555,8 +555,8 @@ Tampons inaltérables
une ligne contenant le mot «nomirror» au fichier de données du tampon.
-
-Taille initiale du tampon
+
+→ Taille initiale du tampon ←
Par défaut, Tux Paint suppose que votre tampon est dimensionné de manière
appropriée pour un affichage non mis à l'échelle sur un canevas de 608x472.
@@ -576,17 +576,17 @@ Taille initiale du tampon
+ "scale 2.5"
+ "scale 2:5"
-
-Utilisateurs de Windows
+
+→ Utilisateurs de Windows ←
Utilisez NotePad ou WordPad pour modifier / créer ces fichiers.
Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont
une extension ".dat" à la fin du nom de fichier.
+
-
-Mise en miroir et retournement
+ ### Mise en miroir et retournement ###
Dans certains cas, vous souhaiterez peut-être fournir une version pré-dessinée
de l'image miroir, de l'image inversée ou même des deux d'un tampon. Par
@@ -629,7 +629,7 @@ sauvegardez, l'image d'origine n'est pas écrasée. De plus, quand vous éditez
votre nouvelle image, les contenus de 'l'image de démarrage' initiale peuvent
l'affecter.
-Images de démarrage avec style 'livre de coloriage'
+ ### Images de démarrage avec style 'livre de coloriage' ###
Le type le plus élémentaire "d'image de démarrage" est similaire à une image
dans un livre de coloriage. C'est le contour d'une forme que vous pouvez
@@ -644,7 +644,7 @@ fichier PNG ou SVG. Si vous sauvegardez en PNG, vous pouvez optionellement
rendre l'image noire et transparente, plutôt que noire et blanche, mais ceci
(depuis Tux Paint 0.9.21) n'est pas requis.
-Images de démarrage avec 'style scénique'
+ ### Images de démarrage avec 'style scénique' ###
En plus de la superposition de style `` livre de coloriage '', vous pouvez
également fournir une image d'arrière-plan séparée dans le cadre d'une "image
@@ -688,7 +688,7 @@ mais après avoir quitté Tux Paint, oi bien une autre image a été chargée, o
bien une nouvelle image a été créée (En d'autres termes, si vous basez un
dessin sur un image de démarrage, il sera toujours changé par lui).
-Options d'image de démarrage
+ ### Options d'image de démarrage ###
Outre une une image, les 'Images de démarrage' peuvent également recevoir
d'autres attributs. Pour ce faire, vous devez créer un «fichier de données»
@@ -702,7 +702,7 @@ Le fichier porte le même nom que l'image , mais une extension ".dat". (par
exemple, le fichier de données "starter.png" est le fichier texte "starter.dat"
qui se trouve dans le même répertoire.)
-allowscale
+→ allowscale ←
Quand une image de démarrage a un ratio d'aspect (proportion largeur/
hauteur) différent de celui du canevas de Tux Paint, elle sera dimensionnée
@@ -745,8 +745,8 @@ allowscale
+ Le comportement par défaut est de ne pas faire de rognage. Ceci peut
être spécifié explicitement avec "allowscale=none".
-
-arrière-plan
+
+→ arrière-plan ←
Cette option vous permet de spécifier comment Tux Paint doit remplir le
reste du canevas, lorsque l'image de démarrage ne s'accorde pas dans l'une
@@ -766,8 +766,8 @@ arrière-plan
Options" pour plus de détails.
-
-gravité
+
+→ gravité ←
Cette option vous permet de spécifier comment Tux Paint doit positionner
une image de démarrage lorsqu'elle a été rognée dans l'une ou l'autre
@@ -792,6 +792,7 @@ gravité
[ Une image au format paysage avec un horizon où le soleil est au milieu et
une construction sur le côté droit. ]
+
Vue sur le centre d'une image de démarrage étirée pour être en accord avec
la largeur du canevas.
@@ -799,6 +800,7 @@ gravité
[ Image au format portrait avec un horizon, le soleil au milieu et le côté
gauche d'une construction à droite. ]
+
Vue sur le centre d'une image de démarrage étirée pour être en accord avec
la hauteur du canevas.
@@ -806,12 +808,14 @@ gravité
[ Image au format paysage avec le ciel, le soleil en bas et le haut d'une
construction sur la droite. ]
+
Vue sur le haut d'une image de démarrage étirée pour être en accord avec la
largeur du canevas.
[ Image, au format paysage, du sol avec le soleil en haut. ]
+
Vue sur le bas d'une image de démarrage étirée pour être en accord avec la
largeur du canevas.
@@ -819,13 +823,14 @@ gravité
[ Image, au format portrait, d'un horizon avec le soleil à gauche et une
construction au milieu. ]
+
Vue sur le droit d'une image de démarrage étirée pour être en accord avec
la hauteur du canevas.
-
+
💡 Note : Les Modèles (description plus bas) peuvent eux aussi avoir des
options, et ont les mêmes options que les images de démarrage.
@@ -870,7 +875,7 @@ nouvelle image a été créée (En d'autres termes, si vous basez un dessin sur
image 'modèle', il sera toujours changé par lui).
-Options des images Modèle
+ ### Options des images Modèle ###
Tout comme 'Les images de démarrage', un fichier de configuration peut être
spécifié, celui-ci décrivant le comportement de Tux Paint quand on utilise des
@@ -1022,7 +1027,7 @@ par différentes dispositions).
Nous utiliserons le clavier QWERTY comme exemple :
-Fichier d'aperçu de la disposition ("qwerty.layout")
+ ### Fichier d'aperçu de la disposition ("qwerty.layout") ###
Il s'agit d'un fichier texte qui spécifie les autres fichiers utilisés pour
décrire l'agencement et la disposition des touches.
@@ -1041,7 +1046,7 @@ La ligne "keyboardlist" décrit les dispositions vers lesquelles on bascule
lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir
ci-dessous.)
-Fichier de disposition du clavier (qwerty.h_layout")
+ ### Fichier de disposition du clavier (qwerty.h_layout") ###
Ceci décrit la taille du clavier (sous forme de grille L × H), et répertorie
chaque touche avec son code numérique (voir le fichier "keymap", ci-dessous),
@@ -1109,7 +1114,7 @@ utilisés sont décrits ci-dessous.
* 2 — disposition précédente (pour le réglage "keyboardlist" du fichier
d'agencement)
-Fichier keymap ("us-intl-altgr-dead-keys.keymap")
+ ### Fichier keymap ("us-intl-altgr-dead-keys.keymap") ###
Ce fichier définit quels codes de touches numériques (vus dans les fichiers de
disposition du clavier, tels que "qwerty.h_layout" décrits ci-dessus) doivent
@@ -1150,7 +1155,7 @@ fichier keymap.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Fichier Composemap ("en_US.UTF-8_Compose")
+ ### Fichier Composemap ("en_US.UTF-8_Compose") ###
Ce fichier décrit les caractères qui peuvent être composés avec plusieurs
entrées. Par exemple, "[Compose]" suivi de "[A] " et "[E]" peut être utilisé
@@ -1161,7 +1166,7 @@ UTF-8 (Unicode) fourni avec le système X Window de X.Org . La version actuelle
de la bibliothèque Xlib se trouve sur la page Web à l' adresse https://
www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html.
-Fichier de définitions des Keysim ("keysymdef.h")
+ ### Fichier de définitions des Keysim ("keysymdef.h") ###
Ce fichier (qui est un fichier d'en-tête du langage de programmation C )
provient également du système X Window . Il définit les valeurs Unicode de
diff --git a/docs/fr_FR.UTF-8/FAQ.txt b/docs/fr_FR.UTF-8/FAQ.txt
index 18637a51f..e674e5171 100644
--- a/docs/fr_FR.UTF-8/FAQ.txt
+++ b/docs/fr_FR.UTF-8/FAQ.txt
@@ -21,16 +21,16 @@
+-----------------------------------+
-------------------------------------------------------------------------------
-Liées au dessin
+ ### Liées au dessin ###
-Les polices que j'ai ajoutées à Tux Paint n'affichent que des carrés
+→ Les polices que j'ai ajoutées à Tux Paint n'affichent que des carrés ←
La police TrueType que vous utilisez peut avoir le mauvais encodage. S'il
est encodé «personnalisé», par exemple, vous pouvez essayer de l'exécuter
via FontForge ( http://fontforge.sourceforge.net/ ) pour le convertir au
format ISO-8859. (Envoyez-nous un e-mail si vous avez besoin d'aide avec
des polices spéciales.)
-
-L'outil Tampon en caoutchouc est grisé !
+
+→ L'outil Tampon en caoutchouc est grisé ! ←
Cela signifie que Tux Paint n'a pas pu trouver d'images de tampons ou a été
invité à ne pas les charger.
@@ -59,8 +59,8 @@ L'outil Tampon en caoutchouc est grisé !
de configuration.
-
-Les contours des tampons sont toujours des rectangles
+
+→ Les contours des tampons sont toujours des rectangles ←
Tux Paint a été élaboré avec des contours de basse qualité (mais plus
rapides).
@@ -73,13 +73,13 @@ Les contours des tampons sont toujours des rectangles
dans le fichier "tuxpaint.c" du répertoire "src".
-
+
-------------------------------------------------------------------------------
-Problèmes d'interface
+ ### Problèmes d'interface ###
-Les vignettes des tampons dans le sélecteur de tampons ne sont pas jolies
+→ Les vignettes des tampons dans le sélecteur de tampons ne sont pas jolies ←
Tux Paint a probablement été compilé avec un code de vignette plus rapide
et de qualité inférieure. Exécutez la commande: "tuxpaint
@@ -94,25 +94,25 @@ Les vignettes des tampons dans le sélecteur de tampons ne sont pas jolies
dans le fichier "tuxpaint.c" du répertoire "src".
-
-Les images de la boîte de dialogue "Ouvrir" ne sont pas jolies
+
+→ Les images de la boîte de dialogue "Ouvrir" ne sont pas jolies ←
"Miniatures de faible qualité" a été probablement activé. Voir : "Les
vignettes de tampon dans le sélecteur de tampon ne sont pas jolies",
ci-dessus.
-
-Tout le texte est en majuscule !
+
+→ Tout le texte est en majuscule ! ←
L'option "majuscule" est activée.
Modifiez / supprimez l'option "uppercase" ou remplacez-la par "--mixedcase"
sur la ligne de commande ou "uppercase=no" ou "mixedcase=yes" dans un des
fichiers de configuration.
-
-Tux Paint est dans une autre langue
+
+→ Tux Paint est dans une autre langue ←
Assurez-vous que vos paramètres régionaux sont corrects. Voir "Tux Paint ne
bascule pas dans ma langue" ci-dessous.
-
-Tux Paint ne bascule pas dans ma langue
+
+→ Tux Paint ne bascule pas dans ma langue ←
+ Utilisateurs Linux et Unix: assurez-vous que les paramètres régionaux
sont disponibles
@@ -155,14 +155,14 @@ Tux Paint ne bascule pas dans ma langue
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Impression
+ ### Impression ###
-Tux Paint n'imprime pas, donne une erreur ou imprime n'importe quoi (Unix /
- Linux)\
+→ Tux Paint n'imprime pas, donne une erreur ou imprime n'importe quoi (Unix /
+ Linux)\ ←
Tux Paint imprime en créant un rendu PostScript de l'image et en l'envoyant
à une commande externe. Par défaut, cette commande est "lpr".
@@ -182,9 +182,9 @@ Tux Paint n'imprime pas, donne une erreur ou imprime n'importe quoi (Unix /
PostScript.
-
-Je reçois le message "Vous ne pouvez pas encore imprimer !" quand je veux
- imprimer
+
+→ Je reçois le message "Vous ne pouvez pas encore imprimer !" quand je veux
+ imprimer ←
L'option "délai d'impression" est activée. Vous ne pouvez imprimer qu'une
fois toutes les X secondes.
@@ -210,8 +210,8 @@ Je reçois le message "Vous ne pouvez pas encore imprimer !" quand je veux
attendre entre les impressions.)
-
-Je ne peux tout simplement pas imprimer ! Le bouton est grisé !
+
+→ Je ne peux tout simplement pas imprimer ! Le bouton est grisé ! ←
L'option "pas d'impression" est activée.
@@ -234,43 +234,43 @@ Je ne peux tout simplement pas imprimer ! Le bouton est grisé !
(sous "Impression") est coché.
-
+
-------------------------------------------------------------------------------
-Sauvegarde
+ ### Sauvegarde ###
-Où Tux Paint enregistre-t-il mes dessins ?
+→ Où Tux Paint enregistre-t-il mes dessins ? ←
Sauf si vous avez demandé à Tux Paint d'enregistrer dans un emplacement
spécifique (en utilisant l'option 'savedir'), Tux Paint enregistre dans un
emplacement standard sur votre disque local :
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g.,
"/Users/nom d'utilisateur/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/nom d'utilisateur/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
Les images sont stockées sous forme de bitmaps PNG, que la plupart des
programmes récents savent lire (éditeurs d'image, éditeurs de texte,
navigateurs, etc ...)
-
-Tux Paint sauvegarde toujours en écrasant mon ancienne image
+
+→ Tux Paint sauvegarde toujours en écrasant mon ancienne image ←
L'option "save over" est activée. (Cela désactive l'invite qui apparaît
lorsque vous cliquez sur «Enregistrer».)
@@ -297,8 +297,8 @@ Tux Paint sauvegarde toujours en écrasant mon ancienne image
ci-dessous.
-
-Tux Paint sauvegarde toujours avec une nouvelle image !
+
+→ Tux Paint sauvegarde toujours avec une nouvelle image ! ←
L'option "never save over" est activée. (Cela désactive l'invite qui
apparaît lorsque vous cliquez sur «Enregistrer».)
@@ -325,13 +325,13 @@ Tux Paint sauvegarde toujours avec une nouvelle image !
image !", ci-dessus.
-
+
-------------------------------------------------------------------------------
-Problèmes audio
+ ### Problèmes audio ###
-Il n'y a pas de son !
+→ Il n'y a pas de son ! ←
+ D'abord, vérifiez ce qui est évident :
o Est-ce que vos haut-parleurs sont branchés et en marche ?
o Est-ce que le volume est correct ?
@@ -396,8 +396,8 @@ Il n'y a pas de son !
disponibles !
-
-Tux Paint fait trop de bruit ! Puis-je arrêter cela ?
+
+→ Tux Paint fait trop de bruit ! Puis-je arrêter cela ? ←
Oui, il existe plusieurs façons de désactiver les sons dans Tux Paint :
@@ -414,9 +414,9 @@ Tux Paint fait trop de bruit ! Puis-je arrêter cela ?
o Autrement, recompilez Tux Paint avec la prise en charge du son
désactivée. (Voir ci-dessus et la documentation 'install' .)
-
-La stéréo des effets sonores est gênante; les effets sonores peuvent-ils être
- monophoniques ?
+
+→ La stéréo des effets sonores est gênante; les effets sonores peuvent-ils être
+ monophoniques ? ←
Lancez Tux Paint avec l'option "no stereo" :
@@ -427,8 +427,8 @@ La stéréo des effets sonores est gênante; les effets sonores peuvent-ils êtr
+ Ou utilisez Tux Paint Config. et assurez-vous que "Activez les effets
stéréo" (sous "Vidéo et son") n'est pas coché.
-
-Les effets sonores sont étranges
+
+→ Les effets sonores sont étranges ←
Cela pourrait avoir un lien avec la façon dont SDL et SDL_mixer ont été
initialisés. (Choix de la taille de la mémoire tampon.)
@@ -438,17 +438,18 @@ Les effets sonores sont étranges
vous utilisez (exécutez "tuxpaint --version" pour vérifier), etc...)
-
+
-------------------------------------------------------------------------------
-Problèmes en mode plein écran
+ ### Problèmes en mode plein écran ###
-Lorsque j'exécute Tux Paint en plein écran et que je fais [Alt] + [Tab], la
- fenêtre devient noire !
+→ Lorsque j'exécute Tux Paint en plein écran et que je fais [Alt] + [Tab], la
+ fenêtre devient noire ! ←
C'est apparemment un bug de la bibbliothèque de SDL. Désolé.
-
-Lorsque j'exécute Tux Paint en plein écran, il est entouré de grandes bordures
+
+→ Lorsque j'exécute Tux Paint en plein écran, il est entouré de grandes
+ bordures ←
Utilisateurs Linux - Votre serveur X-Window n'est probablement pas
configuré avec la possibilité de passer à la résolution souhaitée : 800 ×
@@ -479,9 +480,9 @@ Lorsque j'exécute Tux Paint en plein écran, il est entouré de grandes bordure
exemple.
-
-Tux Paint continue de fonctionner en mode plein écran - je veux qu'il soit
- fenêtré !
+
+→ Tux Paint continue de fonctionner en mode plein écran - je veux qu'il soit
+ fenêtré ! ←
L'option "plein écran" est définie.
@@ -504,20 +505,21 @@ Tux Paint continue de fonctionner en mode plein écran - je veux qu'il soit
"Vidéo et son") n'est pas coché.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-
+
-------------------------------------------------------------------------------
-Autres problèmes
+ ### Autres problèmes ###
-Tux Paint ne veut pas fonctionner
+→ Tux Paint ne veut pas fonctionner ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -545,8 +547,8 @@ Tux Paint ne veut pas fonctionner
fichier de configuration.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -568,8 +570,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-Je ne peux pas quitter Tux Paint
+
+→ Je ne peux pas quitter Tux Paint ←
L'option "noquit" est activée. Cela désactive le bouton "Quitter" dans la
barre d'outils de Tux Paint (en grisé), et empêche Tux Paint d'être fermé
@@ -586,8 +588,8 @@ Je ne peux pas quitter Tux Paint
combinaison [Alt] + [F4] sur votre clavier pour quitter Tux Paint.)
-
-Je ne veux pas que le mode "noquit" soit activé !
+
+→ Je ne veux pas que le mode "noquit" soit activé ! ←
Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous
de ne pas lui donner l'option "--noquit".
@@ -608,9 +610,9 @@ Je ne veux pas que le mode "noquit" soit activé !
Quit et la touche Escape" (sous "Simplification") n'est pas coché.
-
-Tux Paint continue d'écrire des messages étranges à l'écran / dans un fichier
- texte
+
+→ Tux Paint continue d'écrire des messages étranges à l'écran / dans un fichier
+ texte ←
Quelques messages sont normaux, mais si Tux Paint est extrêmement bavard
(comme lister le nom de chaque image de tampon qu'il trouve lors de son
@@ -625,8 +627,8 @@ Tux Paint continue d'écrire des messages étranges à l'écran / dans un fichie
dans le fichier "tuxpaint.c" du répertoire "src".
-
-Tux Paint utilise des options que je n'ai pas spécifiées !
+
+→ Tux Paint utilise des options que je n'ai pas spécifiées ! ←
Par défaut, Tux Paint regarde d'abord les fichiers de configuration pour
les options.
@@ -712,11 +714,11 @@ Tux Paint utilise des options que je n'ai pas spécifiées !
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Aide / Contact
+ ### Aide / Contact ###
Des questions auxquelles vous ne trouvez pas de réponse ? Merci de nous le
faire savoir ! Vous pouvez vous abonner et écrire sur notre liste de diffusion
diff --git a/docs/fr_FR.UTF-8/INSTALL.txt b/docs/fr_FR.UTF-8/INSTALL.txt
index 0d597552c..965d4c378 100644
--- a/docs/fr_FR.UTF-8/INSTALL.txt
+++ b/docs/fr_FR.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Exigences
-Biliothèque Simple DirectMedia Layer (libSDL)
+ ### Biliothèque Simple DirectMedia Layer (libSDL) ###
Tux Paint nécessite la bibliothèque de couches DirectMedia simple (libSDL), une
bibliothèque de programmation multimédia Open Source disponible sous la Licence
@@ -60,13 +60,13 @@ commande apt de Debian).
d'installer AUSSI les versions de développement des paquets (Par ex. installez
les deux "SDL2-2.24.0.rpm" et "SDL2-2.24.0-devel.rpm".)
-Autres bibliothèques
+## Autres bibliothèques ##
Tux Paint profite également d'un certain nombre d'autres bibliothèques
gratuites LGPL. Sous Linux, tout comme SDL, ils devraient être soit déjà
installées, soit facilement disponibles avec votre distribution Linux.
-libPNG
+→ libPNG ←
Tux Paint utilise le format PNG (Portable Network Graphics) pour ses
fichiers de données. SDL_image nécessitera l'installation de libPNG.
@@ -74,8 +74,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint utilise les paramètres régionaux de votre système avec la
bibliothèque "gettext" pour prendre en charge plusieurs langues (par
@@ -85,8 +85,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Linux/Unix uniquement)
+
+→ libpaper (Linux/Unix uniquement) ←
Depuis Tux Paint 0.9.17, Tux Paint peut déterminer le format de papier par
défaut (par exemple, A4 ou Lettre), ou peut être invité à utiliser un
@@ -95,8 +95,8 @@ libpaper (Linux/Unix uniquement)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Les outils "Texte" et "Étiquette" de Tux Paint supportent les langues
bidirectionnelles, grâce à la bibliothèque "FriBidi".
@@ -104,32 +104,32 @@ FriBiDi
http://fribidi.org/
-
-Support des graphismes SVG
+
+→ Support des graphismes SVG ←
À partir de Tux Paint 0.9.17, Tux Paint peut prendre en charge les images
SVG (Scalable Vector Graphics) pour les tampons. Deux ensembles de
bibliothèques sont pris en charge et le support SVG peut être complètement
désactivé (via "make SVG_LIB:==")
- librsvg-2 & libCairo2 (nouvelles bibliothèques)
+ → librsvg-2 & libCairo2 (nouvelles bibliothèques) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o Celles-ci dépendent aussi de :
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Anciennes bibliothèques
+
+ → Anciennes bibliothèques ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o Celles-ci dépendent aussi de :
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Fonction d'exportation de GIF animés
+
+→ Fonction d'exportation de GIF animés ←
Pour prendre en compte l'exportation de GIF animés (diaporama), la
bibliothèque "libimagequant" (issue du projet "pngquant" est nécessaire.
@@ -137,8 +137,8 @@ Fonction d'exportation de GIF animés
https://github.com/ImageOptim/libimagequant
-
-Outils NetPBM (optionnel) Ne sont plus utilisés par défaut
+
+→ Outils NetPBM (optionnel) Ne sont plus utilisés par défaut ←
📜 Sous Linux et Unix, les anciennes versions de Tux Paint utilisaient les
outils NetPBM comme aide à l'impression. (Un PNG est généré par TuxPaint et
@@ -148,7 +148,7 @@ Outils NetPBM (optionnel) Ne sont plus utilisés par défaut
http://netpbm.sourceforge.net/
-
+
Compilation et installation
@@ -158,11 +158,11 @@ disponible gratuitement.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
juillet 10, 2022 Shin-ichi TOYAMA
-Réglages pour compilation
+## Réglages pour compilation ##
Depuis février 2005 (à partir de Tux Paint 0.9.15), le "Makefile" inclut la
prise en charge de la construction sur un système Windows à l'aide de MinGW/
@@ -172,7 +172,7 @@ Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux Pain
Le système de gestion de paquet "pacman" apporte une aide pour installer
automatiquement, en résolvant less nombreuses dépendances.
-MYSYS2
+# MYSYS2 #
Téléchargez le dernier environnement MSYS2 à partir de https://www.msys2.org/
et installez-le où vous voulez (par défaut "C:\msys64")
@@ -200,7 +200,7 @@ environnement de travail 32bit.
-----------------------------------------------------------
-Compilateur MinGW 64bit (x86_64) et outils
+# Compilateur MinGW 64bit (x86_64) et outils #
Sous le shell MSYS2, exécutez la commande suivante pour installer compilateur
64bit et outils basiques de développement :
@@ -212,7 +212,8 @@ vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de
fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour
trouver les fichiers .dll requis.
-bibliothèques de dépendance 64bit (x86_64) pour Tux Paint et Tux Paint Config
+# bibliothèques de dépendance 64bit (x86_64) pour Tux Paint et Tux Paint Config
+#
Vous pouvez installer les outils et bibliothèques nécessaires pour la
compilation de Tux Paint et de Tux Paint Config sur MSYS2/MINGW en utilisant
@@ -226,7 +227,7 @@ Vous pouvez ne pas l'installer si vous compilez seulement "Tux Paint".
💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite.
-Installer SDL2_Pango et libunibreak pour l'environnement 64bit
+# Installer SDL2_Pango et libunibreak pour l'environnement 64bit #
SDL2_Pango et libunibreak doivent être installés manuellement.
@@ -260,7 +261,7 @@ environnement de travail 64bit.
-----------------------------------------------------------
-Compilateur MinGW 32bit (i686) et outils
+# Compilateur MinGW 32bit (i686) et outils #
Sous le shell MSYS2, exécutez la commande suivante pour installer compilateur
32bit et outils basiques de développement :
@@ -272,7 +273,7 @@ vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de
fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour
trouver les fichiers .dll requis.
-bibliothèques de dépendance 32bit (i686) pour Tux Paint et Tux Paint Config
+# bibliothèques de dépendance 32bit (i686) pour Tux Paint et Tux Paint Config #
Vous pouvez installer les outils et bibliothèques nécessaires pour la
compilation de Tux Paint et de Tux Paint Config sur MSYS2/MINGW en utilisant
@@ -286,7 +287,7 @@ Vous pouvez ne pas l'installer si vous compilez seulement "Tux Paint".
💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite.
-Installer SDL2_Pango et libunibreak pour l'environnement 32bit
+# Installer SDL2_Pango et libunibreak pour l'environnement 32bit #
SDL2_Pango et libunibreak doivent être installés manuellement.
@@ -314,7 +315,7 @@ suit.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick est un ensemble d'outils en ligne de commande pour créer, éditer,
composer ou convertir des images bitmap, et qui supporte un grand nombre de
@@ -337,7 +338,7 @@ d'environnement "PATH". Par exemple :
Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre fichier de
configuration du shell BASH, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
Vous pouvez compiler des binaires 64bit en utilisant le shell "MSYS2 64bit", et
des binaires 32bit en utilisant le shell "MSYS32 32bit".
@@ -347,7 +348,7 @@ des binaires 32bit en utilisant le shell "MSYS32 32bit".
* Choisissez "MSYS2 64bit" → "MSYS2 MinGW 32-bit" dans le "Menu de Démarrage"
pour ouvrir le shell 32bit.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" est un outil graphique utile pour ajuster le comportement de
Tux Paint. Vous devez construire ce composant avant de compiler Tux Paint si
@@ -377,7 +378,7 @@ Maintenant vous pouvez faire Tux Paint Config. comme suit :
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
Vous pouvez utiliser soit (a) une version dans une archive tar, soit (b)
l'arbre souce en développement.
@@ -407,7 +408,7 @@ sont rassemblés dans le répertoire de la distribution binaire "bdist",
répertoire situé sous "win323. Vous pouvez les démarrer en double-cliquant
leurs fichiers exéctutables (.exe) dans le répertoire "bdist".
-Construire l'installateur de Tux Paint sous Windows
+## Construire l'installateur de Tux Paint sous Windows ##
Inno Setup est utilisé pour construire l'installeur exécutable de Tux Paint.
Vous devez donc l'installer en premier.
@@ -431,7 +432,7 @@ sélectionner "Compile" dans la liste. Cela prendra un certain temps, et
éventuellement vous obtiendrez un fichier "tuxpaint-X.Y.Z-windows-
-installer.exe" dans le même répertoire.
-Utiliser l'installateur de Tux Paint sous Windows
+## Utiliser l'installateur de Tux Paint sous Windows ##
Double-cliquez sur l'exécutable du programme d'installation de Tux Paint
(fichier .EXE) et suivez les instructions.
@@ -450,7 +451,7 @@ choisissez un autre emplacement.
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint !
-Modification des paramètres à l'aide du raccourci
+## Modification des paramètres à l'aide du raccourci ##
Pour modifier les paramètres du programme, cliquez avec le bouton droit sur le
raccourci TuxPaint et sélectionnez «Propriétés» (en bas).
@@ -479,7 +480,7 @@ aucune modification (sauf si vous avez appuyé sur le bouton "Appliquer" !).
Quand vous avez fini, appuyez sur "OK".
-Si quelque chose ne va pas
+## Si quelque chose ne va pas ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -493,9 +494,9 @@ simplement dû à une casse de caractère incorrecte (majuscule 'Z' à la place
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compilation :
+## Compilation : ##
💡 Remarque :Tux Paint n'utilise pas autoconf/automake, dès lors il n'y a pas de
script "./configure" à lancer. La compilation devrait aller cependant aller
@@ -506,7 +507,8 @@ suivante après une invite shell (par ex. "$") :
$ make
-Désactivation du support SVG (donc des dépendances Cairo, libSVG, et svg-cairo)
+## Désactivation du support SVG (donc des dépendances Cairo, libSVG, et
+svg-cairo) ##
Pour désactiver le support de SVG (par ex. si votre système n'a pas de
bibliothèque Cairo, ou d'autres choses dont SVG est dépendant), vous pouvez
@@ -514,7 +516,7 @@ exécuter "make" avec "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" :
$ make SVG_LIB= SVG_CFLAGS=
-Désactiver le son lors de la compilation
+## Désactiver le son lors de la compilation ##
Si vous n'avez pas de carte son ou si vous préférez créer le programme sans
support sonore (et donc sans dépendance SDL_mixer), vous pouvez exécuter "make"
@@ -522,12 +524,12 @@ avec "SDL_MIXER_LIB=" comme paramètre :
$ make SDL_MIXER_LIB=
-Autres options
+## Autres options ##
Diverses autres options (par exemple, les dossiers d'installation) peuvent être
remplacées; voir dans "Makefile" pour plus de détails.
-Si vous obtenez des erreurs
+## Si vous obtenez des erreurs ##
Si vous avez des erreurs lors de la compilation, assurez-vous d'avoir les
bibliothèques adéquates installées (voir ci-dessus). Si vous utilisez les
@@ -536,7 +538,7 @@ ou les DEB sous Debian), assurez-vous d'avoir choisi également les packages
"-dev" ou "-devel" correspondants, sinon vous ne pourrez pas compiler Tux Paint
(et d'autres programmes) provenant des sources !
-Installation
+## Installation ##
En supposant qu'aucune erreur fatale ne se soit produite, vous pouvez
maintenant installer le programme afin qu'il puisse être exécuté par les
@@ -565,7 +567,7 @@ ex. sur Ubuntu) :
/local/bin/". Les données (images, sons, etc ...) sont dans "/usr/local/share/
tuxpaint/".
-Changer où vont les fichiers
+# Changer où vont les fichiers #
Vous pouvez changer où iront les fichiers en définissant des variables pour
"Makefile" sur la ligne de commande. "DESTDIR" est utilisé pour indiquer la
@@ -574,48 +576,48 @@ fichiers iront et est définie par défaut comme "/usr/local".
Les autres variables sont :
-BIN_PREFIX
+→ BIN_PREFIX ←
Où le binaire "tuxpaint" sera installé. (Par défaut "$(PREFIX)/bin", par
ex. "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Où les fichiers de données (sons, graphiques, pinceaux, tampons, fontes)
iront, et où Tux Paint ira les chercher pour tourner (Réglé à "$(PREFIX)/
share/tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Où sera mise la documentation (les répertoires "docs". 'Réglé à "$(PREFIX)/
share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Où ira la page de manuel de Tuxpaint (Réglé à "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Où iront les icônes et les lanceurs (pour GNOME et KDE)
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Où iront les fichiers de traduction, et où Tux Paint ira les chercher.
(Réglé à "$(PREFIX)/share/locale/") (la destination finale de la traduction
sera dans le répertoire de la locale (par ex "es" pour l'espagnol, dans le
sous-répertoire "LC_MESSAGES").
-
+
💡 Remarque : Cette liste est obsolète. Voir "Makefile" et "Makefile-i18n" pour
une liste complète.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
juin 5, 2022 Mark Kim
À partir de Tux Paint 0.9.23, Tux Paint pour macOS est construit comme si
c'était une application Linux.
-Prérequis
+## Prérequis ##
Bien Tux Paint puisse être construit sans Xcode IDE, ce dernier est toujours
nécessaire. Téléchargez le = partir de l' the App Store, et lancez le une fois
@@ -651,7 +653,7 @@ Tux Paint.
^* Non disponible depuis MacPorts à ce moment, voir ci-dessous.
-libimagequant
+# libimagequant #
libimagequant n'est pas disponible sur MacPorts à cette heure. Il peut être
installé sur /opt/local (comme pour MacPorts) pour la bibliothèque devant être
@@ -663,7 +665,7 @@ incluse dans TuxPaint.dmg.
$ cargo build --release # On doit utiliser cargo venant de Macports
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango n'est pas disponible sur MacPorts à cette heure. Il peut être
installé à partir du code source comme ce qui suit. Il doit être installé sur /
@@ -678,7 +680,7 @@ ATTENTION :Posséder des outils Unix à côté de MacPorts et Xcode, tels que Fi
ou Brew, vous empêchera de créer un programme portable. V"rifiez que Fink et
Brew ne soient pas accessibles via votre environnement de travail.
-Comment construire
+## Comment construire ##
Tapez simplement :
@@ -692,7 +694,7 @@ faites 'make TuxPaint.dmg'.
Des étapes supplémentaires sont nécessaires pour construire un 'Universal
Binary'. Voyez "Construire un Universal Binary" ci-dessous.
-Problèmes connus
+## Problèmes connus ##
* Un binaire macOS construit sur une version spécifique de macOS ne
fonctionnera qu'avec cette version, ou une plus récente. Pour s'assurer que
@@ -711,7 +713,7 @@ Problèmes connus
seules les dépendances (à partir de macOS) doivent être recompilées. Voir
ci-dessous "Recompilation avec MacPorts" pour les instructions.
-Vieilles versions de macOS
+## Vieilles versions de macOS ##
Quelques vieilles versions de macOS peuvent être téléchargées sur la page
d'aide d'Apple : https://support.apple.com/en-us/HT211683
@@ -754,7 +756,7 @@ d'installation des outils de commande en terminal (ne pas exécuter
"xcode-select --install") mais alors vous compilez Tux Paint en utilisant les
mêmes étapes décrites auparavant dans ce document.
-Recompiler MacPorts
+## Recompiler MacPorts ##
Pour recompiler MacPorts afin d'être utilisé sur une ancienne version de macOS,
mettez les options suivantes dans /opt/local/etc/macports/macports.conf :
@@ -781,7 +783,7 @@ lequel elles ont été construites. Voir "Construire un binaire universel"
ci-dessous pour les instructions à suivre pour faire que Tux paint soit un
Binaire Universel.
-Créer un Binaire Universel
+## Créer un Binaire Universel ##
Pour fabriquer Tux Paint en tant que 'Universal Binary', compilez Tux Paint
pour le CPU Intel et pour le Apple Silicon, chacun séparément. Puis renommez
@@ -796,7 +798,7 @@ les deux applications comme ci-dessous. Le fichier DMG, s'il est demandé, doit
-----------------------------------------------------------------------
-Android
+ ### Android ###
mars 29, 2023 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -805,7 +807,7 @@ En mars 2023, la version Android de Tux Paint est maintenue dépôt de logiciel
séparé sur GitHub : https://github.com/tux4kids/Tuxpaint-Android. Les
instructions détaillées sont sur ce site; voici une résumé.
-Prérequis
+## Prérequis ##
Vous avez besoin des versions récentes de :
@@ -831,7 +833,7 @@ contient les dexu.
Remplissez le répertoire app/src/main/assets en exécutant cd app/src/main/jni/
tuxpaint && ./mkzip_assets.sh
-Construire
+## Construire ##
La construction avec Gradle génère quelques variants : PlayStore,
debugPlayStore, offPlayStore et debugoffPlayStore. Vous devez signer ceux qui
@@ -862,36 +864,37 @@ build --server org.tuxpaint:NNNN (NNNN = version, e.g. 9288)
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
mai 7, 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Prérequis
+## Prérequis ##
Installez les paquets de développement requis via un terminal :
-32-bit :
+→ 32-bit : ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit :
+
+→ 64-bit : ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
Pour 32-bit vous devez basculer vers le nouveau compilateur (actuellement gcc
11.2.0) vers setarch x86
-Construire
+## Construire ##
make PREFIX=/boot/home/config/non-packaged
-Tampons pour Tux Paint
+## Tampons pour Tux Paint ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -904,9 +907,9 @@ peut être activé en définissant "DEBUG" (et, si un mode verbeux est souhaité
Désinstallation de Tux Paint
-Windows
+ ### Windows ###
-Utilisation du désinstalleur
+## Utilisation du désinstalleur ##
Si vous avez installé les raccourcis du menu Démarrer (par défaut), accédez au
dossier TuxPaint et sélectionnez "Désinstaller". Une boîte s'affichera qui
@@ -916,12 +919,12 @@ sur le bouton 'Désinstaller'.
Quand c'est fini, cliquez sur "Fermer".
-En utilisant le panneau de configuration
+## En utilisant le panneau de configuration ##
Il est également possible d'utiliser l'entrée "TuxPaint (supprimer uniquement)"
dans la Section Ajout / Suppression de programmes du Panneau de configuration.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
@@ -929,7 +932,7 @@ the configuration files, stamps, and saved pictures, may be found in
"/Users/nom d'utilisateur/Library/Application Support/TuxPaint/" (individual
users).
-Linux
+ ### Linux ###
Dans le répertoire source de Tux Paint (où vous avez compilé Tux Paint), vous
pouvez utiliser une cible "make uninstall" pour désinstaller Tux Paint. Par
diff --git a/docs/fr_FR.UTF-8/MAGIC-API.txt b/docs/fr_FR.UTF-8/MAGIC-API.txt
index 06032cdf1..93475c9da 100644
--- a/docs/fr_FR.UTF-8/MAGIC-API.txt
+++ b/docs/fr_FR.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/fr_FR.UTF-8/OPTIONS.txt b/docs/fr_FR.UTF-8/OPTIONS.txt
index 96dab4816..50a50f911 100644
--- a/docs/fr_FR.UTF-8/OPTIONS.txt
+++ b/docs/fr_FR.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Documentation sur les options
+ ### Documentation sur les options ###
Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
https://tuxpaint.org/
@@ -47,11 +47,11 @@ Vous pouvez créer un fichier de configuration simple pour Tux Paint, qu'il lira
Le fichier est simplement un fichier texte contenant les options que vous
souhaitez activer :
-Utilisateurs de Linux et Unix
+ ### Utilisateurs de Linux et Unix ###
/home/nom d'utilisateur/.tuxpaintrc
-Fichier de configuration pour l'ensemble du système
+## Fichier de configuration pour l'ensemble du système ##
Avant la lecture de ce fichier, un fichier de configuration à l'échelle du
système est lu. (Par défaut, cette configuration n'a pas de paramètres
@@ -59,11 +59,11 @@ activés.) Il se trouve normalement ici :
/etc/tuxpaint/tuxpaint.conf
-Utilisateurs de macOS
+ ### Utilisateurs de macOS ###
/Users/nom d'utilisateur/Library/Application Support/TuxPaint/tuxpaint.cfg
-Fichier de configuration pour l'ensemble du système
+## Fichier de configuration pour l'ensemble du système ##
Avant la lecture de ce fichier, un fichier de configuration à l'échelle du
système est lu. (Par défaut, cette configuration n'a pas de paramètres
@@ -71,7 +71,7 @@ activés.) Il se trouve normalement ici :
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Utilisateurs de Windows
+ ### Utilisateurs de Windows ###
C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\tuxpaint.cfg
@@ -79,7 +79,7 @@ Vous pouvez utiliser NotePad ou WordPad pour créer ce fichier. Assurez-vous de
l'enregistrer en tant que texte brut et assurez-vous que le nom de fichier ne
contient pas ".txt" à la fin ...
-Fichier de configuration pour l'ensemble du système
+## Fichier de configuration pour l'ensemble du système ##
Avant la lecture de ce fichier, un fichier de configuration à l'échelle du
système est lu. (Par défaut, cette configuration n'a pas de paramètres
@@ -87,7 +87,7 @@ activés.) Il se trouve normalement ici :
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -102,11 +102,11 @@ Les paramètres suivants peuvent être définis dans le fichier de configuration
(Les paramètres de ligne de commande les remplaceront. Reportez-vous à la
section "Options de ligne de commande " ci-dessous.)
-Vidéo/Son
+ ### Vidéo/Son ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Le programme tourne en plein écran plutôt que dans une fenêtre.
@@ -116,15 +116,15 @@ fullscreen=yes
l'option en ligne de commande "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Le programme tourne plein écran, en adoptant la résolution actuelle de
l'écran (définie par le système d'exploitation).
-
-windowsize=SIZE
+
+→ windowsize=SIZE ←
Exécute le programme à une taille différente (en mode fenêtré) ou à une
résolution d'écran différente (en mode plein écran), plutôt que la valeur
@@ -146,8 +146,8 @@ windowsize=SIZE
possibilités de l'écran, Tux Paint resdescendra aux dimensions de l'écran.
-
-orient=portrait
+
+→ orient=portrait ←
Permute les options de largeur / hauteur données à Tux Paint, utile pour
faire pivoter la fenêtre pour les affichages de portait, comme un écran PC
@@ -159,16 +159,16 @@ orient=portrait
l'option en ligne de commande "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
Lorsque vous exécutez Tux Paint en mode plein écran, cela suppose la
résolution actuelle de l'écran (remplaçant toute option "windowsize"), est
celle définie par le système d'exploitation.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -182,11 +182,11 @@ allowscreensaver=yes
"--disablescreensaver".
+
+## Son ##
-Son
-
-nosound=yes
+→ nosound=yes ←
Désactive les effets sonores. (Remarque: le fait d'appuyer sur [Alt] + [S]
ne peut pas être utilisé pour réactiver les sons s'ils ont été désactivés à
@@ -198,8 +198,8 @@ nosound=yes
remplacé avec l'option en ligne de commande "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Désactive la prise en charge de la stéréo. (Utile pour les utilisateurs
ayant une déficience auditive avec une oreille ou dans les endroits où un
@@ -211,11 +211,11 @@ nostereo=yes
remplacé avec l'option en ligne de commande "--stereo".
+
+## Taille de l'interface ##
-Taille de l'interface
-
-buttonsize=SIZE
+→ buttonsize=SIZE ←
Règle la taille en pixel des boutons de l'interface de Tux Paint
(remplaçant la valeur de "48" par défaut). Utile quand on utilise des
@@ -236,8 +236,8 @@ buttonsize=SIZE
(Une remarque apparaîtra sur le terminal en stderr.)
-
-colorsrows=ROWS
+
+→ colorsrows=ROWS ←
Combien de rangées de boutons pour les couleurs peuvent être montrées;
utile quand on a une grande palette (voir "colorfile ci-dessus), et/ou pour
@@ -245,13 +245,13 @@ colorsrows=ROWS
oculomètres). "ROWS" peut être entre "1" (par défaut) et "3".
+
+ ### Souris/Clavier ###
-Souris/Clavier
+## Curseur ##
-Curseur
-
-nofancycursors=yes
+→ nofancycursors=yes ←
Cela désactive les formes fantaisistes de pointeur de souris dans Tux Paint
et utilise le pointeur de souris normal de votre environnement.
@@ -265,8 +265,8 @@ nofancycursors=yes
peut être remplacé avec l'option en ligne de commande "--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
Cela masque complètement les formes du pointeur de la souris dans Tux
Paint.
@@ -280,11 +280,11 @@ hidecursor=yes
être remplacé avec l'option en ligne de commande "--showcursor".
+
+## Clavier ##
-Clavier
-
-noshortcuts=yes
+→ noshortcuts=yes ←
Cela désactive les raccourcis clavier (par exemple [Ctrl]-[S] pour
enregistrer, [Ctrl]-[N] pour une nouvelle image, etc.)
@@ -298,11 +298,11 @@ noshortcuts=yes
être remplacé avec l'option en ligne de commande "--shortcuts".
+
+## Souris ##
-Souris
-
-grab=yes
+→ grab=yes ←
Tux Paint essaiera de «saisir» la souris et le clavier, en sorte que la
souris reste confinée dans la fenêtre de Tux Paint et que presque toutes
@@ -319,8 +319,8 @@ grab=yes
remplacé avec l'option en ligne de commande "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
Cela désactive la prise en charge de la molette pour les souris qui en ont.
(Normalement, la molette fait défiler le menu du sélecteur sur la droite.)
@@ -331,8 +331,8 @@ nowheelmouse=yes
être remplacé avec l'option en ligne de commande "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Avant Tux Paint 0.9.15, les boutons du milieu et de droite d'une souris
pouvaient également être utilisés pour cliquer. Dans la version 0.9.15,
@@ -351,13 +351,13 @@ nobuttondistinction=yes
"--buttondistinction".
+
+ ### Simplification ###
-Simplification
+## Simplification de l'interface ##
-Simplification de l'interface
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Désactive la possibilité de rotation avec l'outil «Forme». Cliquer, faire
glisser et relâcher, voilà tout ce qui sera possible pour dessiner une
@@ -369,8 +369,8 @@ simpleshapes=yes
peut être remplacé avec l'option en ligne de commande "--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
Dans ce mode, des contours beaucoup plus simples et des lignes «élastiques»
sont affichés lors de l'utilisation des outils Ligne , Forme , Tampon et
@@ -385,8 +385,8 @@ nooutlines=yes
être remplacé avec l'option en ligne de commande "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
Tout le texte sera rendu uniquement en majuscules (par exemple, "Boule"
deviendra "BOULE"). Utile pour les enfants qui savent lire, mais qui n'ont
@@ -398,11 +398,11 @@ uppercase=yes
être remplacé avec l'option en ligne de commande "--mixedcase".
+
+## Taille initiale du tampon ##
-Taille initiale du tampon
-
-stampsize=SIZE
+→ stampsize=SIZE ←
Utilisez cette option pour forcer Tux Paint à définir la taille de départ
de tous les tampons. La valeur SIZE doit être comprise entre 0 (le plus
@@ -414,11 +414,11 @@ stampsize=SIZE
standard).
+
+## Simplification du contrôle ##
-Simplification du contrôle
-
-noquit=yes
+→ noquit=yes ←
Désactive le bouton "Quitter" à l'écran et empêche la touche [Escape] de
quitter Tux Paint .
@@ -436,8 +436,8 @@ noquit=yes
remplacé avec l'option en ligne de commande "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
Cette option indique à Tux Paint de ne charger aucune image de tampon en
caoutchouc, ce qui entraîne la désactivation de l' outil Tampons .
@@ -452,8 +452,8 @@ nostamps=yes
remplacé avec l'option en ligne de commande "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Certaines images de l' outil Tampon peuvent être mises en miroir, inversées
et / ou voir leur taille modifiée. Cette option désactive ces contrôles et
@@ -465,8 +465,8 @@ nostampcontrols=yes
il peut être remplacé avec l'option en ligne de commande "--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
Cela désactive la rotation des Tampons mettant immédiatement le tampon dans
son orientation normale (le retournement ou la réflection peuvent être
@@ -481,8 +481,8 @@ nostamprotation=yes
il peut être remplacé avec l'option en ligne de commande "--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Certains outils Magie ont la possibilité d'agir comme un pinceau ou
d'affecter le canevas en entier. Cette option désactive les contrôles et ne
@@ -494,8 +494,8 @@ nomagiccontrols=yes
il peut être remplacé avec l'option en ligne de commande "--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Certaibs outils Magie peuvent avoir plusieurs réglages de taille. Cette
option annule cette possibilité et ne permet que la taille par défaut.
@@ -508,8 +508,8 @@ nomagicsizes=yes
être remplacé avec l'option en ligne de commande "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -526,8 +526,8 @@ ungroupmagictools=yes
"--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Désactive les boutons de contrôle affichés lors de l'utilisation de l'
outil Formes qui permettent de modifier la façon dont les formes sont
@@ -540,8 +540,8 @@ noshapecontrols=yes
il peut être remplacé avec l'option en ligne de commande "--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Désactive l'outil Étiquette : l'outil qui permet la saisie de texte pouvant
être édité plus tard.
@@ -552,8 +552,8 @@ nolabel=yes
remplacé avec l'option en ligne de commande "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Désactive l'option brush spacingespacement des coups de pinceaux pour les
outils Peindre et Lignes . L'espacement par défaut sera utilisé.
@@ -568,8 +568,8 @@ nobrushspacing=yes
peut être remplacé avec l'option en ligne de commande "--brushspacing".
-
-complexity=COMPLEXITÉ
+
+→ complexity=COMPLEXITÉ ←
Règle le niveau de complexité (expertise) de Tux Paint, qui permet soit de
déactiver certains outils de Magie, ou de changer leur comportement. (Par
@@ -579,19 +579,19 @@ complexity=COMPLEXITÉ
La valeur COMPLEXITÉ peut l'une de celles-ci :
- advanced (par défaut)
+ → advanced (par défaut) ←
"Avancé" — Pour les utilisateurs familiers avec Tux Paint et qui
peuvent œuvrer avec de outils plus complexes.
-
- beginner
+
+ → beginner ←
"Débutant" — Pour les utilisateurs habitués à Tux Paint, mais les
outils complexes peuvent leur causer confusion ou frustration.
-
- novice
+
+ → novice ←
"Novice" — Pour les utilisateurs qui débutent avec Tux Paint, ou bien
qui ont peu d'expérience des ordinateurs, ou bien encore ceux qui ont
besoin d'outils spéciaux pour l'accessibilité
-
+
📜 Note : Ll'option de complexité a été ajoutée dans la version 0.9.32 de
Tux Paint. Consultez la documentation individuelle des outils Magiei.
@@ -602,8 +602,8 @@ complexity=COMPLEXITÉ
avec l'option en ligne de commande "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Désactive la possibilité de créer de nouvelles images Modèle (basées sur
des images sauvegardées) à partir de la boîte de dialogue Ouvrir .
@@ -618,8 +618,8 @@ notemplateexport=yes
"--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Désactive la possibilité d'effacer des images sauvegardées via le bouton
"Effacer" de la boîte de dialogue Ouvrir , ou bien d'images Modèle
@@ -636,13 +636,13 @@ noerase=yes
remplacé avec l'option en ligne de commande "--erase".
+
+ ### Langues ###
-Langues
+## Langue ##
-Langue
-
-lang=LANGUAGE
+→ lang=LANGUAGE ←
Exécutez Tux Paint dans l'une des langues prises en charge. Les choix
possibles pour la LANGUE comprennent actuellement :
@@ -904,8 +904,8 @@ lang=LANGUAGE
+-----------------------------------------------------------------+
-
---locale LOCALE
+
+→ --locale LOCALE ←
Exécutez Tux Paint dans l'une des langues supportées. Consultez la section
Choisir une autre langue" ci-dessous pour les chaînes de paramètres
@@ -916,8 +916,8 @@ lang=LANGUAGE
respecte les paramètres de votre environnement, si possible.)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
Pour les tampons qui peuvent être mis en miroir, cette option les définit
par défaut sur leur forme en miroir.
@@ -932,11 +932,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Polices ##
-Polices
-
-sysfonts=yes
+→ sysfonts=yes ←
Cette option oblige Tux Paint à essayer de charger des polices (à utiliser
dans l'outil Texte ) à partir de votre système d'exploitation. Normalement,
@@ -948,8 +948,8 @@ sysfonts=yes
être remplacé avec l'option en ligne de commande "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Avant la version 0.9.21, Tux Paint chargeait toutes les polices depuis son
propre répertoire de polices, y compris celles spécifiques à la locale (par
@@ -968,8 +968,8 @@ alllocalefonts=yes
"--currentlocalefont".
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
Cette option oblige Tux Paint à essayer de charger des polices (à utiliser
dans l'outil Texte ) à partir de votre système d'exploitation. Normalement,
@@ -979,19 +979,19 @@ uifont=FONT NAME
Sans" (c'est un comportement standard).
+
+ ### Impression ###
-Impression
+## Permissions pour l'impression ##
-Permissions pour l'impression
-
-noprint=yes
+→ noprint=yes ←
Désactive la fonction d'impression.
-
-printdelay=SECONDES
+
+→ printdelay=SECONDES ←
Limite l'impression afin que l'impression ne puisse avoir lieu qu'une fois
toutes les SECONDES secondes.
@@ -1002,11 +1002,11 @@ printdelay=SECONDES
l'option en ligne de commande "--printdelay=0".
+
+## Montrer le menu pour l'impression ##
-Montrer le menu pour l'impression
-
-altprint=always
+→ altprint=always ←
Cela fait que Tux Paint affiche toujours la boîte de dialogue de
l'imprimante (ou, sous Linux / Unix, lance la "commande altprint") lorsque
@@ -1015,8 +1015,8 @@ altprint=always
de maintenir [Alt] à chaque fois.
-
-altprint=never
+
+→ altprint=never ←
Cela empêche Tux Paint de ne jamais montrer la boîte de dialogue de l'
imprimante (ou, sous Linux / Unix, exécuter « altprintcommand ») lorsque le
@@ -1024,8 +1024,8 @@ altprint=never
[Alt] sans effet lorsque vous cliquez sur le bouton «Imprimer».
-
-altprint=mod
+
+→ altprint=mod ←
C'est le comportement par défaut. Tux Paint affiche une boîte de dialogue
d'imprimante (ou, sous Linux / Unix, exécute la commande "altprint"),
@@ -1034,11 +1034,11 @@ altprint=mod
de boîte de dialogue.
+
+## Sauvegarder la configuration d'impression ##
-Sauvegarder la configuration d'impression
-
- printcfg=yes
+ → printcfg=yes ←
(Windows et macOS uniquement)
@@ -1061,11 +1061,11 @@ Sauvegarder la configuration d'impression
"--noprintcfg".
+
+ ## Commandes d'impression ##
- Commandes d'impression
-
- printcommand=COMMAND
+ → printcommand=COMMAND ←
(Linux et Unix uniquement)
@@ -1083,8 +1083,8 @@ Sauvegarder la configuration d'impression
configuration avant la version 0.9.15, vous devrez la modifier.
-
- altprintcommand=COMMAND
+
+ → altprintcommand=COMMAND ←
(Linux et Unix uniquement)
@@ -1100,11 +1100,11 @@ Sauvegarder la configuration d'impression
kprinter
+
+ ## Format du papier ##
- Format du papier
-
- papersize=PAPERSIZE
+ → papersize=PAPERSIZE ←
(Plates-formes qui utilisent le générateur PostScript interne de Tux
Paint - pas Windows, macOS, BeOS ou Haiku.)
@@ -1121,21 +1121,21 @@ Sauvegarder la configuration d'impression
dsheet, esheet.
+
+ ### Sauvegarde ###
- Sauvegarde
+ ## Écraser le travail précédent ##
- Écraser le travail précédent
-
- saveover=yes
+ → saveover=yes ←
Ceci élimine le message "Écraser l'ancienne version ...? quand on
voulait sauvegarder un fichier déjà existant. Avec cette option,
l'ancienne version sera écrasée par la nouvelle, automatiquement.
-
- saveover=new
+
+ → saveover=new ←
Ceci aussi élimine le message "Écraser l'ancienne version ...? quand on
sauvegarde un fichier déjà existant. Cette option, cependant,
@@ -1143,19 +1143,19 @@ Sauvegarder la configuration d'impression
version.
-
- saveover=ask
+
+ → saveover=ask ←
(Cette option est redondante puisque c'est celle par défaut.) Quand
vous sauvegardez un dessin déjà existant, on vous demandera d'abord si
vous voulez écraser l'ancienne version ou non.
+
+ ## Démarrer ##
- Démarrer
-
- startblank=yes
+ → startblank=yes ←
Ceci oblige Tux Paint à afficher un canevas vide au démarrage, plutôt
que la dernière image qui a été éditée.
@@ -1167,8 +1167,8 @@ Sauvegarder la configuration d'impression
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Place les options de couleur dans la boîte de dialogue Nouveau en
dernier, ainsi tous les démarreurs et / ou modèles seront affichés en
@@ -1181,11 +1181,11 @@ Sauvegarder la configuration d'impression
commande "--newcolorsfirst".
+
+ ## Répertoires de sauvegarde et d'export ##
- Répertoires de sauvegarde et d'export
-
- savedir=DIRECTORY
+ → savedir=DIRECTORY ←
Utilisez cette option pour changer l'emplacement du répertoire /
dossier "saved" de Tux Paint , qui est l'endroit où Tux Paint
@@ -1193,19 +1193,19 @@ Sauvegarder la configuration d'impression
Si vous ne le changez pas, l' emplacement par défaut est :
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/nom d'utilisateur/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/nom d'utilisateur/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note : Si vous spécifiez un lecteur Windows (pzr ex. "H:\"), vous
devez spécifiez également un sous-répertoire.
@@ -1219,8 +1219,8 @@ Sauvegarder la configuration d'impression
Exemple: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORY
+
+ → exportdir=DIRECTORY ←
Utilisez cette option pour modifier l'endroit où Tux Paint exporte les
fichiers - images uniques ou diaporamas GIF animés - en vue d'un usage
@@ -1262,11 +1262,11 @@ Sauvegarder la configuration d'impression
Exemple: exportdir=/home/penguin/TuxPaintExports
+
+ ## Plus d'options de sauvegarde ##
- Plus d'options de sauvegarde
-
- nosave=yes
+ → nosave=yes ←
Ceci désactive la possibilité de sauvegarder les fichiers par Tux Paint
(et par conséquent ôte le bouton "Sauvegarder" sur l'écran). On peut
@@ -1279,8 +1279,8 @@ Sauvegarder la configuration d'impression
cas, il peut être remplacé avec l'option en ligne de commande "--save".
-
- autosave=yes
+
+ → autosave=yes ←
Ceci empêche Tux Paint de vous demander si vous voulez sauvegarder
l'image quand vous quittez, et suppose que vous le faites.
@@ -1292,8 +1292,8 @@ Sauvegarder la configuration d'impression
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
Ceci inverse le tri des fichiers dans les dialogues Ouvrir et
Diaporama; plaçant les nouvelles images en tête de liste.
@@ -1305,13 +1305,13 @@ Sauvegarder la configuration d'impression
commande "--noreversesort".
+
+ ### Données ###
- Données
+ ## Fichier de verouillage ##
- Fichier de verouillage
-
- nolockfile=yes
+ → nolockfile=yes ←
Par défaut, Tux Paint utilise ce qu'on appelle un «fichier de
verrouillage» pour éviter qu'il ne soit lancé plus d'une fois toutes
@@ -1335,11 +1335,11 @@ Sauvegarder la configuration d'impression
"--lockfile".
+
+ ## Répertoire de données ##
- Répertoire de données
-
- datadir=DIRECTORY
+ → datadir=DIRECTORY ←
Utilisez cette option pour changer l'endroit où Tux Paint ira
rechercher les fichiers de données personnelles (pinceaux, tampons,
@@ -1351,15 +1351,15 @@ Sauvegarder la configuration d'impression
Si vous ne le changez pas, l' emplacement par défaut est :
- Linux / Unix
+ → Linux / Unix ←
/home/nom d'utilisateur/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/nom d'utilisateur/Library/Application Support/TuxPaint/
-
+
📜 Note : Avant la version 0.9.18, Tux Paint utlisait les mêmes réglages
que "savedir" pour chercher les fichiers de données. Depuis la version
@@ -1371,11 +1371,11 @@ Sauvegarder la configuration d'impression
Exemple: datadir=/home/johnny/tuxpaint-data/
+
+ ## Fichier de palette de couleur ##
- Fichier de palette de couleur
-
- colorfile=FILENAME
+ → colorfile=FILENAME ←
Vous pouvez remplacer la palette de couleurs par défaut de Tux Paint en
créant un fichier texte ASCII simple qui décrit les couleurs souhaitées
@@ -1405,24 +1405,24 @@ Sauvegarder la configuration d'impression
identique à " #FFFFFF", mais pas à "#F0F0F0".
+
+ ### Accessibilité ###
- Accessibilité
+ ## Souris ##
- Souris
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
Dans ce mode, au lieu de cliquer, de faire glisser et de relâcher (par
exemple, pour dessiner), vous cliquez, déplacez et cliquez à nouveau
pour terminer le mouvement.
+
+ ## Clavier ##
- Clavier
-
- keyboard=yes
+ → keyboard=yes ←
Cela permet d'utiliser les touches fléchées du clavier pour contrôler
le pointeur de la souris. (Par exemple, pour les environnements sans
@@ -1468,18 +1468,18 @@ Sauvegarder la configuration d'impression
"--mouse".
+
+ ## Clavier virtuel sur écran ##
- Clavier virtuel sur écran
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Présente un clavier à l'écran cliquable lors de l'utilisation des
outils Texte et Étiquette .
-
- onscreen-keyboard-layout=LAYOUTNAME
+
+ → onscreen-keyboard-layout=LAYOUTNAME ←
Choisit une disposition initiale pour le clavier virtuel quand on
utilise les outils Texte et Étiquette .
@@ -1487,8 +1487,8 @@ Sauvegarder la configuration d'impression
onscreen-keyboard=yes , la configuration des deux est donc redondante.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Désactive la possibilité de modifier la disposition du clavier à
l'écran lors de l'utilisation des outils Texte et Étiquette , utile
@@ -1503,54 +1503,54 @@ Sauvegarder la configuration d'impression
"--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Écran principal ##
- Écran principal
-
- joystick-dev=N
+ → joystick-dev=N ←
Spécifie quel périphérique joystick doit être utilisé par Tux Paint. La
valeur par défaut est 0 (le premier joystick).
-
- joystick-slowness=SPEED
+
+ → joystick-slowness=SPEED ←
Définit un retard à chaque mouvement d'axe, permettant de ralentir le
joystick. Les valeurs autorisées sont comprises entre 0 et 500. La
valeur par défaut est 15.
-
- joystick-threshold=THRESHOLD
+
+ → joystick-threshold=THRESHOLD ←
Définit le niveau minimum de mouvement de l'axe pour commencer à
déplacer le pointeur. Les valeurs autorisées sont comprises entre 0 et
32766. La valeur par défaut est 3200.
-
- joystick-maxsteps=STEPS
+
+ → joystick-maxsteps=STEPS ←
Définit le nombre de pixels maximums que le pointeur déplacera à la
fois. Les valeurs autorisées vont de 1 à 7. La valeur par défaut est 7.
+
+ ## Chapeau ##
- Chapeau
-
- joystick-hat-slowness=SPEED
+ → joystick-hat-slowness=SPEED ←
Définit un délai à chaque mouvement automatique, permettant de ralentir
la vitesse du chapeau. Les valeurs autorisées sont comprises entre 0 et
500. La valeur par défaut est 15.
-
- joystick-hat-timeout=MILLISECONDS
+
+ → joystick-hat-timeout=MILLISECONDS ←
Définit le délai après lequel le pointeur commencera à se déplacer
automatiquement si le chapeau est maintenu enfoncé. Les valeurs
@@ -1558,11 +1558,11 @@ Sauvegarder la configuration d'impression
000.
+
+ ## Boutons à désactiver ##
- Boutons à désactiver
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
Un ensemble de numéros de boutons du joystick, comme vu par SDL, qui
doit être ignoré. Sinon, à moins qu'ils ne soient utilisés par l'une
@@ -1570,133 +1570,133 @@ Sauvegarder la configuration d'impression
comme un clic gauche de la souris.
+
+## Boutons pour raccourcis ##
-Boutons pour raccourcis
-
- joystick-btn-escape=BUTTON NUMBER
+ → joystick-btn-escape=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, tel que vu par SDL, qui
sera utilisé pour générer un événement d'échappement. Utile pour fermer
les dialogues et quitter.
-
- joystick-btn-brush=BUTTON NUMBER
+
+ → joystick-btn-brush=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Pinceau.
-
- joystick-btn-stamp=BUTTON NUMBER
+
+ → joystick-btn-stamp=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Tampon.
-
- joystick-btn-lines=BUTTON NUMBER
+
+ → joystick-btn-lines=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Lignes.
-
- joystick-btn-shapes=BUTTON NUMBER
+
+ → joystick-btn-shapes=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Formes.
-
- joystick-btn-text=BUTTON NUMBER
+
+ → joystick-btn-text=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Texte.
-
- joystick-btn-label=BUTTON NUMBER
+
+ → joystick-btn-label=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Étiquette.
-
- joystick-btn-fill=BUTTON NUMBER
+
+ → joystick-btn-fill=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil de remplissage.
-
- joystick-btn-magic=BUTTON NUMBER
+
+ → joystick-btn-magic=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sélectionne l'outil Magie.
-
- joystick-btn-undo=BUTTON NUMBER
+
+ → joystick-btn-undo=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner invoque l'outil Défaire.
-
- joystick-btn-redo=BUTTON NUMBER
+
+ → joystick-btn-redo=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner outil Refaire.
-
- joystick-btn-eraser=BUTTON NUMBER
+
+ → joystick-btn-eraser=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner outil Gomme.
-
- joystick-btn-new=BUTTON NUMBER
+
+ → joystick-btn-new=BUTTON NUMBER ←
Sélectionne le numéro de bouton du joysticke, comme vu par SDL, qui
sera un raccourci pour lancer la boîte dialogue pour créer un nouveau
dessin.
-
- joystick-btn-open=BUTTON NUMBER
+
+ → joystick-btn-open=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, tel que vu par SDL, qui
sera un raccourci pour lancer la boîte de dialogue pour ouvrir un
dessin existant.
-
- joystick-btn-save=BUTTON NUMBER
+
+ → joystick-btn-save=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner sauvegarder le dessin.
-
- joystick-btn-pgsetup=BUTTON NUMBER
+
+ → joystick-btn-pgsetup=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner lancer la boîte de dialogue pour le
réglage de l'imprssion.
-
- joystick-btn-print=BUTTON NUMBER
+
+ → joystick-btn-print=BUTTON NUMBER ←
Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera
un raccourci pour sélectionner print.
-
+
Écraser des options de System Config
@@ -1722,7 +1722,7 @@ Boutons pour raccourcis
Des options peuvent également être émises sur la ligne de commande lorsque
vous démarrez Tux Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--WIDTHxHEIGHT
--orient=portrait
@@ -1804,13 +1804,14 @@ Boutons pour raccourcis
--reversesort
--lang LANGUAGE
--colorfile FILE
+ ←
Celles-ci activent ou correspondent aux options du fichier de
configuration décrites ci-dessus.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1851,6 +1852,7 @@ Boutons pour raccourcis
--save
--noautosave
--noreversesort
+ ←
Ces options peuvent être utilisées pour remplacer les paramètres
définis dans le fichier de configuration. (Si l'option n'est pas
@@ -1858,8 +1860,8 @@ Boutons pour raccourcis
remplacement n'est nécessaire.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1869,54 +1871,54 @@ Boutons pour raccourcis
be used.
+
-
- Options d'information en ligne de commande
+ ### Options d'information en ligne de commande ###
Les options suivantes affichent des informations sur l'écran. Cependant,
Tux Paint ne démarrera pas et ne s'exécutera pas.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Afficher de brèves informations de licence au sujet de la copie de Tux
Paint.
-
- --usage
+
+ → --usage ←
Affiche la liste des options disponibles en ligne de commande.
-
- --help
+
+ → --help ←
Affiche une aide sommaire sur l'utilisation de Tux Paint.
-
- --lang help
+
+ → --lang help ←
Affiche une liste des langues disponibles dans Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Afficher la liste des joysticks branchés qui sont disponibles pour Tux
Paint.
-
+
Choisir une autre langue
@@ -1932,7 +1934,7 @@ Boutons pour raccourcis
Utilisez l'option "--lang help" pour lister les options de langues
disponibles.
- Langues disponibles
+ ### Langues disponibles ###
+-------------------------------------------------------------------------+
| Code ISO 639-1 | Langue | Langue | Combinaison de |
@@ -2232,7 +2234,7 @@ Boutons pour raccourcis
combinaisons de touches répertoriées peuvent être utilisées pour parcourir
les méthodes de saisie prises en charge lorsque l' outil Texte est actif.
- Définition des paramètres régionaux de votre environnement
+ ### Définition des paramètres régionaux de votre environnement ###
La modification de vos paramètres régionaux affectera une grande partie de
votre environnement.
@@ -2245,7 +2247,7 @@ Boutons pour raccourcis
Si vous n'avez pas encore défini les paramètres régionaux de votre
environnement, ce qui suit explique brièvement comment :
- Utilisateurs de Linux/Unix
+ ## Utilisateurs de Linux/Unix ##
Tout d'abord, assurez-vous que les paramètres régionaux que vous souhaitez
utiliser sont activés en éditant le fichier "/etc/locale.gen" sur votre
@@ -2277,7 +2279,7 @@ Boutons pour raccourcis
setenv LANG es_ES ; \
tuxpaint
- Utilisateurs de Windows
+ ## Utilisateurs de Windows ##
Tux Paint reconnaîtra les paramètres régionaux en cours et utilisera les
fichiers appropriés par défaut. Cette section est donc réservée aux
@@ -2303,7 +2305,7 @@ Boutons pour raccourcis
+ Cliquez sur le bouton "Variables d'environnement ...".
+ Édite la valeur du paramètre "LANG" (le crée s'il n'existe pas).
- Polices spéciales
+ ### Polices spéciales ###
Certaines langues nécessitent l'installation de polices spéciales. Ces
fichiers de polices (qui sont au format TrueType (TTF)), sont beaucoup trop
diff --git a/docs/fr_FR.UTF-8/PNG.txt b/docs/fr_FR.UTF-8/PNG.txt
index 5a4506afc..c63d0356d 100644
--- a/docs/fr_FR.UTF-8/PNG.txt
+++ b/docs/fr_FR.UTF-8/PNG.txt
@@ -28,12 +28,12 @@ La prise en charge de nombreuses couleurs permet aux images "tampons de
caoutchouc" de qualité photo d'être utilisable dans Tux Paint, et la
transparence alpha permet une haute qualité pour les pinceaux.
-Comment créer des PNG
+ ### Comment créer des PNG ###
Ce qui suit est une très brève liste de méthodes pour créer des PNG ou
convertir des images existantes en PNG.
-GIMP & Krita
+→ GIMP & Krita ←
D'excellents outils pour créer des images PNG utilisables dans Tux Paint
sont Gimp et Krita, tous deux programmes interactifs de dessin et d'édition
@@ -45,10 +45,10 @@ GIMP & Krita
visitez respectivement http://www.gimp.org/ et http://www.krita.org/.
+
+→ Outils en ligne de commande ←
-Outils en ligne de commande
-
- NetPBM
+ → NetPBM ←
Les outils Bitmap portables (appelés généralement «NetPBM») sont une
collection d'outils de ligne de commande Open Source qui convertissent
@@ -61,8 +61,8 @@ Outils en ligne de commande
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
Les programmes en ligne de commande "cjpeg" et "djpeg" font la
conversion entre le format PNM (Portable Any Map) de NetPBM et les
@@ -72,11 +72,11 @@ Outils en ligne de commande
https://jpegclub.org/.
+
-
-
-Logiciel propriétaire pour Windows
+
+→ Logiciel propriétaire pour Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -84,13 +84,13 @@ Logiciel propriétaire pour Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Utilisateurs de Macintosh
+
+→ Utilisateurs de Macintosh ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/fr_FR.UTF-8/README.txt b/docs/fr_FR.UTF-8/README.txt
index 3340ee79e..8152402c6 100644
--- a/docs/fr_FR.UTF-8/README.txt
+++ b/docs/fr_FR.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
version 0.9.34
- Un programme simple pour les enfants
+ ## Un programme simple pour les enfants ##
Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
https://tuxpaint.org/
- octobre 12, 2024
+ octobre 14, 2024
+-------------------------------------------------------+
| Table des matières |
@@ -44,7 +44,7 @@
I. À propos de Tux Paint
-A. Qu'est-ce que "Tux Paint" ?
+ ### A. Qu'est-ce que "Tux Paint" ? ###
Tux Paint est un programme de dessin gratuit conçu pour les jeunes enfants
(enfants de 3 ans et plus). Il possède une interface simple et facile à
@@ -53,46 +53,46 @@ encourager et guider les enfants lorsqu'ils utilisent le programme. Sont
fournis un canevas vierge et un ensemble d'outils de dessin pour aider votre
enfant à être créatif.
-B. Objectifs
+ ### B. Objectifs ###
-Facile et amusant
+→ Facile et amusant ←
Tux Paint se veut un simple programme de dessin pour les jeunes enfants. Il
ne s'agit pas d'un programme de dessin à usage général. Il se veut amusant
et facile à utiliser. Les effets sonores et un personnage de dessin animé
permettent à l'utilisateur de savoir ce qui se passe tout en le
divertissant. Il existe également des pointeurs de souris, de style dessin
animé, extra-larges.
-
-Flexibilité
+
+→ Flexibilité ←
Tux Paint est extensible. Les brosses et les formes de "tampon en
caoutchouc" peuvent être déposées et retirées. Par exemple, un enseignant
peut apporter une collection de formes animales et demander à ses élèves de
dessiner un écosystème. Chaque forme peut avoir un son qui l'accompagne et
un texte est affiché lorsque l'enfant sélectionne la forme.
-
-Portabilité
+
+→ Portabilité ←
Tux Paint est portable sur diverses plates-formes informatiques: Windows,
Macintosh, Linux, etc. L'interface est la même sur toutes. Tux Paint
fonctionne correctement sur les systèmes plus anciens (comme un Pentium
133), et peut être modifié pour mieux fonctionner sur des systèmes lents.
-
-Simplicité
+
+→ Simplicité ←
Il n'y a pas d'accès direct à la complexité sous-jacente de l'ordinateur.
L'image en cours est conservée lorsque le programme se ferme et réapparaît
au redémarrage. L'enregistrement d'images ne nécessite pas la création de
noms de fichiers ou l'utilisation du clavier. L'ouverture d'une image se
fait en la sélectionnant dans une collection de vignettes. L'accès à
d'autres fichiers sur l'ordinateur est restreint.
-
-Accessibilité
+
+→ Accessibilité ←
Tux Paint offre un grand nombre d'options pour l'accessibilité, comprenant
l'augmentation de la taille des boutons de contrôle, le changement des
fontes utilisateur, des options pour contrôler le pointeur de souris en
utilisant le clavier ou d'autres dispostifs d'entrée (joystick, manette de
jeu, etc ..), un clavier virtuel, et des clics de souris "collants".
+
-
-C. Licence
+ ### C. Licence ###
Tux Paint est un projet Open Source, un logiciel libre publié sous la licence
publique générale GNU (GPL). Il est gratuit et le «code source» du programme
@@ -102,62 +102,76 @@ logiciel sous GPL.)
Voir COPYING.txt pour le texte complet de la licence GPL.
-D. Qu'y a-t-il de neuf dans la version 0.9.34 de Tux Paint ?
+ ### D. Qu'y a-t-il de neuf dans la version 0.9.34 de Tux Paint ? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
Voir CHANGES.txt pour la liste complète des changements.
II. Utiliser Tux Paint
-A. Lancement de Tux Paint
+ ### A. Lancement de Tux Paint ###
-1. Utilisateurs de Linux/Unix
+## 1. Utilisateurs de Linux/Unix ##
Tux Paint devrait avoir mis une icône de lanceur dans vos menus KDE et/ou
GNOME, sous «Graphiques».
@@ -170,7 +184,7 @@ exemple, "$") :
Si des erreurs se produisent, elles seront affichées sur le terminal
("stderr").
-2. Utilisateurs de Windows
+## 2. Utilisateurs de Windows ##
[Icône pour Tux Paint]
Tux Paint
@@ -194,13 +208,14 @@ installer.
Si vous avez utilisé le téléchargement de 'ZIP-file', le dossier de Tux Paint
sera là où vous l'avez placé lorsque vous avez décompressé le fichier ZIP.
-3. Utilisateurs de macOS
+## 3. Utilisateurs de macOS ##
Double-cliquez simplement sur l'icône "Tux Paint".
[Écran-titre]
+
-B. Écran titre
+ ### B. Écran titre ###
Lors du premier chargement de Tux Paint, un écran avec titre et crédits
apparaîtra.
@@ -209,20 +224,22 @@ Une fois le chargement terminé, appuyez sur une touche ou cliquez sur la souris
pour continuer. (Ou, après environ 30 secondes, l'écran-titre disparaîtra
automatiquement.)
-C. Écran principal
+ ### C. Écran principal ###
L'écran principal est divisé en plusieurs sections :
[Outils : Peindre, Tampon, Lignes, Formes, Texte, Magie, Étiquette, Défaire,
Refaire, Gomme, Nouveau, Ouvrir, Sauvegarder, Imprimer, Quitter]
-Côté gauche : la barre d'outils
+
+→ Côté gauche : la barre d'outils ←
La barre d'outils contient les commandes pour dessiner et éditer.
-
+
[Toile]
-Milieu : Toile pour Dessiner
+
+→ Milieu : Toile pour Dessiner ←
La plus grande partie de l'écran, au centre, est le canevas pour dessiner.
C'est évidemment là que vous dessinerez !
@@ -233,9 +250,10 @@ Milieu : Toile pour Dessiner
documentation OPTIONS pour plus de détails.
-
+
[Sélecteurs - Pinceaux, Lettres, Formes, Tampons]
-Côté droit : sélecteur
+
+→ Côté droit : sélecteur ←
En fonction de l'outil en cours d'utilisation, le sélecteur affiche
différentes choses. Par exemple, lorsque l'outil Pinceau est sélectionné,
@@ -244,10 +262,11 @@ Côté droit : sélecteur
pouvez utiliser.
-
+
[Couleurs - Noir, Blanc, Rouge, Rose, Orange, Jaune, Vert, Cyan, Bleu,
Pourpre, Brun, Gris]
-En bas : couleurs
+
+→ En bas : couleurs ←
Quand l'outil en cours utilise des couleurs, une palette pour choisir des
couleurs se trouve en bas de l'écran. Cliquez sur une pour choisir une
@@ -308,23 +327,24 @@ En bas : couleurs
Options" .
-
+
(Par exemple : Choisis une forme. Clique pour démarrer le dessin , fais
glisser et continue jusqu'à la taille désirée. Déplace-toi pour la faire
tourner, et clique pour dessiner.)
-En bas : zone d'aide
+
+→ En bas : zone d'aide ←
Tout en bas de l'écran, Tux, le pingouin Linux, fournit des conseils et
d'autres informations pendant que vous dessinez.
+
+ ### D. Outils disponibles ###
-D. Outils disponibles
+## 1. Outils de dessin ##
-1. Outils de dessin
-
-a. Outil "Peinture" (pinceau)
+a. Outil "Peinture" (pinceau) ←
L'outil Pinceau vous permet de dessiner à main levée, en utilisant
différents pinceaux (choisis dans le sélecteur à droite) et couleurs
@@ -371,8 +391,8 @@ a. Outil "Peinture" (pinceau)
documentation "Options".
-
-b.Outil "Tampon" (tampon de caoutchouc)
+
+b.Outil "Tampon" (tampon de caoutchouc) ←
L'outil Tampon montre un ensemble de tampons en caoutchouc ou
d'autocollants. Il vous permet de coller des images pré-dessinées ou
@@ -383,13 +403,13 @@ b.Outil "Tampon" (tampon de caoutchouc)
indiquant où le tampon sera placé, ainsi que sa taille. Cliquez sur le
canevas à l'endroit où vous voulez placer le tampon.
- Catégories de tampons
+ → Catégories de tampons ←
Il peut y avoir de nombreuses catégories de timbres (par ex. animaux,
plantes, espace extra-atmosphérique, véhicules, personnes, etc.).
Utilisez les flèches gauche et droite pour parcourir les différentes
collections.
-
- Rotation des tampons
+
+ → Rotation des tampons ←
En utilisant le bouton de rotation en bas à droite, vous pouvez
effectuer une rotation quand vous placez un tampon. Une fois le tampon
@@ -406,8 +426,8 @@ b.Outil "Tampon" (tampon de caoutchouc)
Tux Paint avec la version 0.9.29.
-
- Contrôles des tampons
+
+ → Contrôles des tampons ←
Avant de `` tamponner '' une image sur votre dessin, différents effets
peuvent parfois être appliqués (en fonction du tampon) :
@@ -429,8 +449,8 @@ b.Outil "Tampon" (tampon de caoutchouc)
Agrandir pour les tampons. Voir la documentation "Options".
-
- Effets sonores des tampons
+
+ → Effets sonores des tampons ←
Les tampons peuvent avoir un effet sonore et / ou une description orale
(parlés). Les boutons en bas à gauche (près de Tux, le pingouin Linux)
@@ -438,11 +458,11 @@ b.Outil "Tampon" (tampon de caoutchouc)
tampon actuellement sélectionné.
+
-
-
-c.Outil "Lignes"
+
+c.Outil "Lignes" ←
Cet outil vous permet de dessiner des lignes droites à l'aide des
différents pinceaux et couleurs que vous utilisez habituellement.
@@ -468,8 +488,8 @@ c.Outil "Lignes"
du pinceau, ci-dessus pour en savoir plus.
-
-d.Outil "Formes"
+
+d.Outil "Formes" ←
Cet outil vous permet de dessiner des formes simples remplies ou non
remplies.
@@ -480,15 +500,15 @@ d.Outil "Formes"
Utilisez les options en bas à droite pour choisir le comportement de
l'outil :
- Formes à partir du centre
+ → Formes à partir du centre ←
La forme se développe à partir de l'endroit où vous avez cliqué
initialement et sera centrée autour de cette position.
📜 C'était le seul comportement de Tux Paint jusqu'à la version 0.9.24.
-
- Formes à partir d'un coin
+
+ → Formes à partir d'un coin ←
La forme se développe à partir d'un coin depuis l'endroit où vous avez
cliqué initialement. Il s'agit de la méthode par défaut de la plupart
des autres logiciels de dessin traditionnels.
@@ -497,7 +517,7 @@ d.Outil "Formes"
Paint.
-
+
⚙ Remarque : si les contrôles de forme sont désactivés (par exemple, avec
l'option "noshapecontrols"), il n'y aura pas de contrôle et la méthode
@@ -516,7 +536,7 @@ d.Outil "Formes"
Relâchez la souris lorsque vous avez terminé l'étirement.
- Mode normal
+ → Mode normal ←
Maintenant vous pouvez bouger la souris autour du canevas pour faire
tourner la forme. L'angle de rotation est indiqué en bas, en degrés
@@ -526,8 +546,8 @@ d.Outil "Formes"
avec la couleur en cours.
-
- Mode de Formes Simples
+
+ → Mode de Formes Simples ←
Si l'option "formes simples" est activée, la forme sera dessinée sur le
canevas lorsque vous relâcherez le bouton de la souris. (Il n'y a pas
de rotation.)
@@ -536,11 +556,11 @@ d.Outil "Formes"
formes simples" ("simpleshapes").
+
-
-
-e.Outils "Texte" et "Étiquette"
+
+e.Outils "Texte" et "Étiquette" ←
Choisissez une police (parmi les «Lettres» disponibles sur la droite) et
une couleur (dans la palette de couleurs en bas). Vous pouvez aussi
@@ -561,7 +581,7 @@ e.Outils "Texte" et "Étiquette"
active entraîne le déplacement de la ligne de texte actuelle vers cet
emplacement (et vous pouvez continuer à la modifier).
- "Texte" par rapport à "Étiquette"
+ → "Texte" par rapport à "Étiquette" ←
L' outil Texte est l'outil de saisie de texte original de Tux Paint. Le
texte saisi à l'aide de cet outil ne peut pas être modifié ou déplacé
@@ -598,8 +618,8 @@ e.Outils "Texte" et "Étiquette"
Tux Paint en ligne de commande avec l'option "nolabel").
-
- Saisie de caractères internationaux
+
+ → Saisie de caractères internationaux ←
Tux Paint permet de saisir des caractères dans différentes langues. La
plupart des caractères latins ( A - Z , ñ , è , etc...) peuvent être
@@ -626,8 +646,8 @@ e.Outils "Texte" et "Étiquette"
voir les caractères que vous essayez de saisir.
-
- Clavier virtuel sur écran
+
+ → Clavier virtuel sur écran ←
Un clavier virtuel sur écran (optionnel) est disponible pour les outils
"Texte" et "Étiquette", qui peut présenter une palette de dispositions
@@ -637,11 +657,11 @@ e.Outils "Texte" et "Étiquette"
d'informations.
+
-
-
-f.Outil "Remplir"
+
+f.Outil "Remplir" ←
L'outil «Remplir» «remplit» une zone contiguë de votre dessin avec une
couleur unie de votre choix. Trois options de remplissage sont offertes :
@@ -667,8 +687,8 @@ f.Outil "Remplir"
dans la version 0.9.29 de Tux Paint.
-
-g.Outil "Magie" (Effets spéciaux)
+
+g.Outil "Magie" (Effets spéciaux) ←
L'outil «Magie» est en fait un ensemble d'outils spéciaux. Sélectionnez
l'un des effets «magiques» dans le sélecteur de droite. Ensuite, selon
@@ -723,8 +743,8 @@ g.Outil "Magie" (Effets spéciaux)
one large list. See the "Options" documentation.
-
-h.Outil "Gomme"
+
+h.Outil "Gomme" ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -756,11 +776,11 @@ h.Outil "Gomme"
sélectionné.
+
+## 2. Autres contrôles ##
-2. Autres contrôles
-
-a.Commandes "Défaire" et "Refaire"
+a.Commandes "Défaire" et "Refaire" ←
Cliquer sur le bouton "Défaire" annulera la dernière action. Vous pouvez
même annuler plus d'une fois !
@@ -778,8 +798,8 @@ a.Commandes "Défaire" et "Refaire"
clavier pour Refaire.
-
-b.Commande "Nouveau"
+
+b.Commande "Nouveau" ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -793,14 +813,14 @@ b.Commande "Nouveau"
⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [N] sur le
clavier pour commencer un nouveau dessin.
- Choix de couleurs unies en arrière plan
+ → Choix de couleurs unies en arrière plan ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Écran principal > En bas : couleurs > Special color
options for details.
-
- Images de "Démarrage" et images "Modèle"
+
+ Images de "Démarrage" et images "Modèle" ←
o Les "Images de démarrage" se comportent comme une page d'un livre
de coloriage - un contour noir et blanc d'une image, que vous
pouvez ensuite colorier, et le contour noir reste intact - ou comme
@@ -835,8 +855,8 @@ b.Commande "Nouveau"
Voir "Ouvrir", ci-dessous.
-
- Effacement des images Modèles exportées
+
+ → Effacement des images Modèles exportées ←
Si vous avez sélectionner une Image Modèle dans votre répertoire
personnel, et qu'il a été créé à partir de Tux Paint (en utilisant le
@@ -853,15 +873,15 @@ b.Commande "Nouveau"
"noerase".
-
+
⚙ Note : Les couleurs unies peuvent être placées à la fin de la boîte de
dialogue 'Nouveau' (dessous les Images de démarrage et Modèles), via
l'option "newcolorslast".
-
-c.Commande "Ouvrir"
+
+c.Commande "Ouvrir" ←
Cela vous montre une liste de toutes les images que vous avez enregistrées.
S'il y en a plus que ce que peut contenir l'écran, utilisez les flèches
@@ -920,8 +940,8 @@ c.Commande "Ouvrir"
clavier pour afficher la boîte de dialogue "Ouvrir".
-
-d.Commande "Sauvegarder"
+
+d.Commande "Sauvegarder" ←
Pour sauvegarder votre image en cours.
@@ -946,8 +966,8 @@ d.Commande "Sauvegarder"
clavier pour sauvegarde.
-
-e.Commande "Imprimer"
+
+e.Commande "Imprimer" ←
Cliquez sur ce bouton et votre image sera imprimée !
@@ -957,7 +977,7 @@ e.Commande "Imprimer"
pas fonctionner si vous exécutez Tux Paint en mode plein écran. Voir
ci-dessous.
- Désactivation de l'impression
+ → Désactivation de l'impression ←
On peut définir une option "noprint", ce qui entraînera la
désactivation du bouton "Imprimer".
@@ -965,8 +985,8 @@ e.Commande "Imprimer"
⚙ Voir la documentation sur "Options".
-
- Restreindre l'impression
+
+ → Restreindre l'impression ←
Si l'option "printdelay" a été utilisée, vous ne pouvez imprimer —
qu'une fois toutes les x secondes, tel que vous l'avez défini.
@@ -977,8 +997,8 @@ e.Commande "Imprimer"
⚙ Voir la documentation sur "Options".
-
- Commandes d'impression
+
+ → Commandes d'impression ←
(Linux et Unix uniquement)
@@ -1003,8 +1023,8 @@ e.Commande "Imprimer"
⚙ Voir la documentation sur "Options".
-
- Réglages pour l'impression
+
+ → Réglages pour l'impression ←
(Windows et macOS)
@@ -1027,8 +1047,8 @@ e.Commande "Imprimer"
⚙ Voir la documentation sur "Options".
-
- Options de la boîte de dialogue de l'imprimante
+
+ → Options de la boîte de dialogue de l'imprimante ←
Par défaut, Tux Paint affiche uniquement la boîte de dialogue de
l'imprimante (ou, sous Linux / Unix, exécute "altprintcommand", par
@@ -1045,18 +1065,18 @@ e.Commande "Imprimer"
⚙ Voir la documentation sur "Options".
+
-
-
-f.Commande "Diapos" (sous "Ouvrir")
+
+f.Commande "Diapos" (sous "Ouvrir") ←
Le bouton "Diapositives" est disponible dans la boîte de dialogue "Ouvrir".
Il peut être utilisé pour lire une simple animation dans Tux Paint, ou un
diaporama. Il peut également exporter un GIF animé basé sur les images
choisies.
- Choisir des images
+ → Choisir des images ←
Lorsque vous entrez dans la section "Diapos" de Tux Paint, il affiche
une liste de vos fichiers enregistrés, tout comme la boîte de dialogue
@@ -1071,8 +1091,8 @@ f.Commande "Diapos" (sous "Ouvrir")
souhaitez l'ajouter à la fin de la liste.
-
- Régler la vitesse de lecture
+
+ → Régler la vitesse de lecture ←
Une échelle mobile en bas à gauche de l'écran (à côté du bouton
"Lecture") peut être utilisée pour régler la vitesse du diaporama ou du
@@ -1087,8 +1107,8 @@ f.Commande "Diapos" (sous "Ouvrir")
exporté.)
-
- Lecture dans Tux Paint
+
+ → Lecture dans Tux Paint ←
Pour démarrer un diaporama dans Tux Paint, cliquez sur le bouton
'Jouer'.
@@ -1106,8 +1126,8 @@ f.Commande "Diapos" (sous "Ouvrir")
d'image du diaporama.
-
- Exporter un GIF animé
+
+ → Exporter un GIF animé ←
Cliquez sur le bouton "Exporter GIF" en bas à droite pour que Tux Paint
génère un fichier GIF animé basé sur les images sélectionnées.
@@ -1121,14 +1141,14 @@ f.Commande "Diapos" (sous "Ouvrir")
vous ramènera à la boîte de dialogue "Diaporama".
-
+
Cliquez sur "Retour" dans l'écran de sélection d'image du diaporama pour
revenir à la boîte de dialogue "Ouvrir".
-
-g.Commande "Quitter"
+
+g.Commande "Quitter" ←
Cliquez sur le bouton "Quitter", fermez la fenêtre de Tux Paint ou appuyez
sur la touche [Escape] pour quitter Tux Paint.
@@ -1158,8 +1178,8 @@ g.Commande "Quitter"
⚙ Voir la documentation sur "Options".
-
-h.Coupure du son
+
+h.Coupure du son ←
Il n'y a pas de bouton de commande à l'écran pour le moment, mais en
appuyant sur les touches [Alt] + [S] , les effets sonores peuvent être
@@ -1173,11 +1193,11 @@ h.Coupure du son
⚙ Voir la documentation sur "Options".
+
+ ### E. Contrôle de Tux Paint ###
-E. Contrôle de Tux Paint
-
-1. Utiliser une Souris ou une Boule de pointage
+## 1. Utiliser une Souris ou une Boule de pointage ##
Le mode principal de travail pour Tux Paint est avec tout dispositif reconnu
par votre système d'exploitation tel que la souris, soit standard, soit boule
@@ -1195,7 +1215,7 @@ Paint ne reconnaît qu'un seul bouton. Cependant vous pouvez configurer Tux
Paint pour accepter un autre bouton comme entrée (voir la Options
documentation).
-a. Défilement
+# a. Défilement #
Beaucoup de dispositifs d'entrée offre un moyen d'effectuer un défilement
rapide — beaucoup de souris ont une roulette de défilement, les boules de
@@ -1209,7 +1229,7 @@ Vous pouvez avoir un défilement automatique en cliquant et en maintenant
enfoncé sur un bouton de défilement — les flèches "haut" et "bas" apparaissant
au-dessus et en-dessous de la liste.
-b. Accessibilité de la souris
+# b. Accessibilité de la souris #
Yous dispositf ressemblant à une souris peut être utilisé pour contrôler Tux
Paint. Par exemple :
@@ -1222,7 +1242,7 @@ Tux Paint possède un réglage d'accessibilité "clic collant", où un simple cl
permet de faire "cliquer et glisser", et autre clic l'arrête. ( (Voir la
Options documentation.)
-2. Utiliser une Tablette ou un Écran tactile
+## 2. Utiliser une Tablette ou un Écran tactile ##
Comme indiqué précédemment, Tux Paint reconnaît tout dispositif ressemblant à
une souris. Ce qui veut dire que les tablettes graphiques et les écrans
@@ -1235,7 +1255,7 @@ Paint. Quelques examples :
* Conseil pour la Gomme
* Gestes avec plusieurs doigts
-3. Utiliser un dispositif de type joystick
+## 3. Utiliser un dispositif de type joystick ##
Tux Paint peut être configuré pour reconnaître l'entrée de tout contrôleur de
jeu qui apparaît dans votre système dexploitation tel qu'un joystick. Ceci
@@ -1250,7 +1270,7 @@ différents contrôles de Tux Paint (par ex. pour actionner la touche [Escape],
pour invoquer les opérations Faire et Défaire, etc ...). Voir la documentation
pour plus de détails Options .
-4. Utiliser le clavier
+## 4. Utiliser le clavier ##
Tux Paint fournit une option pour permettre d'utiliser le clavier pour
contrôler le pointeur de souris. Cela inclut le mouvement et le clic, aussi
@@ -1259,7 +1279,7 @@ parties de l'interface. Voir la documentation pour plus de détails Options.
III. Chargement d'autres images dans Tux Paint
-A. Aperçu
+ ### A. Aperçu ###
Étant donné que la boîte de dialogue «Ouvrir» de Tux Paint n'affiche que les
images que vous avez créées avec Tux Paint, que se passe-t-il si vous souhaitez
@@ -1270,30 +1290,30 @@ Pour ce faire, il vous suffit de convertir l'image dans le format utilisé par
Tux Paint, qui est —PNG (Portable Network Graphic), et de la placer dans le
répertoire "saved" de Tux Paint. C'est là où on les trouve (par défaut) :
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\nom d'utilisateur\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g.,
"/Users/nom d'utilisateur/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/nom d'utilisateur/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Remarque : C'est également à partir de ce dossier que vous pouvez copier ou
ouvrir des images dessinées dans Tux Paint à l'aide d'autres applications,
ainsi l'option 'Export' de la boîte de dialogue 'Ouvrir' de Tux Paint peut être
utilisée pour les copier dans un endroit plus facile d'accès plus sûr.
-B. Utilisation du script d'importation "tuxpaint-import"
+ ### B. Utilisation du script d'importation "tuxpaint-import" ###
Les utilisateurs Linux et Unix peuvent utiliser script shell "tuxpaint-import"
qui s'installe lorsque vous installez Tux Paint. Il utilise certains outils
@@ -1330,7 +1350,7 @@ Vous pouvez maintenant charger Tux Paint, et une version de cette image
originale sera disponible dans la boîte de dialogue «Ouvrir». Double-cliquez
simplement sur son icône !
-C. Importer des images manuellement
+ ### C. Importer des images manuellement ###
Les utilisateurs de Windows, macOS et Haiku désirant importer des images dans
Tux Paint doivent le faire manuellement.
@@ -1349,7 +1369,7 @@ taille de la fenêtre Tux Paint, ou de la résolution à laquelle Tux Paint est
exécuté, si il est en plein écran. (Remarque : la résolution par défaut est de
800x600.) Voir "Calculer les dimensions des images" ci-dessous.
-1. Nom du fichier
+## 1. Nom du fichier ##
Sauvegarder l'image au format PNG. Il est fortement recommandé que vous nommiez
le fichier en utilisant la date et l'heure courante, puisque c'est ce que Tux
@@ -1368,7 +1388,7 @@ Exemple: "20210731110500.png",pour le 31 juillet 2021 à 11:05 du matin.
Mettez cd fichier PNG dans votre répertoire Tux Paint "saved". (Voir ci-dessus)
-2. Calculer les dimensions des images
+## 2. Calculer les dimensions des images ##
Cette partie de documentation doit être réécrite puisque la nouvelle option
"buttonsize" a été ajoutée. Pour l'heure, essayer de dessiner et de sauvegarder
@@ -1381,7 +1401,7 @@ IV.Lectures complémentaires
Les autres documents inclus avec Tux Paint (dans le répertoire "docs") incluent
:
-Utiliser Tux Paint :
+→ Utiliser Tux Paint : ←
+ OPTIONS.html
Instructions détaillées sur les options en ligne de commande et les
fichiers de configuration, pour ceux qui ne veulent pas utiliser
@@ -1392,8 +1412,8 @@ Utiliser Tux Paint :
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-Extensions pour Tux Paint :
+
+→ Extensions pour Tux Paint : ←
+ EXTENDING.html
Des instructions détaillées sur la création de pinceaux, de tampons,
d'images de démarrage et de modèles; et l'ajout de polices; et créer un
@@ -1405,8 +1425,8 @@ Extensions pour Tux Paint :
Remarques sur la création d'images vectorielles au format SVG à
utiliser dans Tux Paint.
-
-Information technique :
+
+→ Information technique : ←
+ INSTALL.html
Instructions pour compiler et installer Tux Paint, le cas échéant.
+ SIGNALS.html
@@ -1414,8 +1434,8 @@ Information technique :
+ MAGIC-API.html
Créer de nouveaux outils Magie avec le plugin API de Tux Paint.
-
-Historique du développement et licence :
+
+→ Historique du développement et licence : ←
+ AUTHORS.txt
Liste des auteurs et contributeurs.
+ CHANGES.txt
@@ -1423,7 +1443,7 @@ Historique du développement et licence :
+ COPYING.txt
Licence du programme Tux Paint, la GNU General Public License (GPL)
-
+
V.Comment obtenir de l'aide
diff --git a/docs/fr_FR.UTF-8/SIGNALS.txt b/docs/fr_FR.UTF-8/SIGNALS.txt
index 521de579c..b45ef7beb 100644
--- a/docs/fr_FR.UTF-8/SIGNALS.txt
+++ b/docs/fr_FR.UTF-8/SIGNALS.txt
@@ -10,7 +10,8 @@
Tux Paint répond aux signaux suivants (qui peuvent être envoyé au processus du
programme via `kill` ou`killall`, par exemple).
-SIGTERM (également, [Control] + [C] depuis un terminal exécutant 'tuxpaint')
+→ SIGTERM (également, [Control] + [C] depuis un terminal exécutant 'tuxpaint')
+ ←
Tux Paint répond comme si le bouton "Quitter" était enfoncé, ou
l'environnement de bureau a été invité à fermer Tux Paint (par exemple, en
@@ -33,8 +34,8 @@ SIGTERM (également, [Control] + [C] depuis un terminal exécutant 'tuxpaint')
bouton "Retour" dans Tux Paint a été cliqué, ou la touche [Esc] enfoncée.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint répond en définissant son option "autosave" (comme si cela avait
été lancé avec "--autosave"), aussi bien que l'option pour toujours
@@ -55,5 +56,5 @@ SIGUSR1 & SIGUSR2
fois pour qu'il s'arrête complètement.
-
+
diff --git a/docs/fr_FR.UTF-8/SVG.txt b/docs/fr_FR.UTF-8/SVG.txt
index e8085de7a..982ceb261 100644
--- a/docs/fr_FR.UTF-8/SVG.txt
+++ b/docs/fr_FR.UTF-8/SVG.txt
@@ -26,12 +26,12 @@ et disponible sous Windows, macOS et Linux. Il y a également d'autres
programmes pour faire du SVG, à la fois gratuits/open source et commerciaux/
propriétaires.
-Logiciel libre
+→ Logiciel libre ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Propriétaire
+
+→ Propriétaire ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/fr_FR.UTF-8/html/EXTENDING.html b/docs/fr_FR.UTF-8/html/EXTENDING.html
index ee2abbc90..d6c03ae61 100644
--- a/docs/fr_FR.UTF-8/html/EXTENDING.html
+++ b/docs/fr_FR.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Une image au format paysage avec un horizon où le soleil est au milieu et une construction sur le côté droit. ]"
title="Une image au format paysage avec un horizon où le soleil est au milieu et une construction sur le côté droit."
valign="middle" />
+
Vue sur le centre d'une image de démarrage étirée pour être en accord avec la largeur du canevas.
@@ -884,6 +885,7 @@
alt="[ Image au format portrait avec un horizon, le soleil au milieu et le côté gauche d'une construction à droite. ]"
title="Image au format portrait avec un horizon, le soleil au milieu et le côté gauche d'une construction à droite."
valign="middle" />
+
Vue sur le centre d'une image de démarrage étirée pour être en accord avec la hauteur du canevas.
@@ -897,6 +899,7 @@
alt="[ Image au format paysage avec le ciel, le soleil en bas et le haut d'une construction sur la droite. ]"
title="Image au format paysage avec le ciel, le soleil en bas et le haut d'une construction sur la droite."
valign="middle" />
+
Vue sur le haut d'une image de démarrage étirée pour être en accord avec la largeur du canevas.
@@ -910,6 +913,7 @@
alt="[ Image, au format paysage, du sol avec le soleil en haut. ]"
title="Image, au format paysage, du sol avec le soleil en haut."
valign="middle" />
+
Vue sur le bas d'une image de démarrage étirée pour être en accord avec la largeur du canevas.
@@ -923,6 +927,7 @@
alt="[ Image, au format portrait, d'un horizon avec le soleil à gauche et une construction au milieu. ]"
title="Image, au format portrait, d'un horizon avec le soleil à gauche et une construction au milieu."
valign="middle" />
+
Vue sur le droit d'une image de démarrage étirée pour être en accord avec la hauteur du canevas.
diff --git a/docs/fr_FR.UTF-8/html/README.html b/docs/fr_FR.UTF-8/html/README.html
index cae51f615..753d2fa9d 100644
--- a/docs/fr_FR.UTF-8/html/README.html
+++ b/docs/fr_FR.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- octobre 12, 2024
+ octobre 14, 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- New brushes
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Écran-titre]">
+
B. Écran titre
@@ -412,6 +413,7 @@
height="254"
alt=
"[Outils : Peindre, Tampon, Lignes, Formes, Texte, Magie, Étiquette, Défaire, Refaire, Gomme, Nouveau, Ouvrir, Sauvegarder, Imprimer, Quitter]">
+
-
Côté gauche : la barre d'outils
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Toile]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[Sélecteurs - Pinceaux, Lettres, Formes, Tampons]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[Couleurs - Noir, Blanc, Rouge, Rose, Orange, Jaune, Vert, Cyan, Bleu, Pourpre, Brun, Gris]">
+
-
@@ -486,13 +491,14 @@
Quand l'outil en cours utilise des couleurs, une palette pour choisir des couleurs se trouve en bas de l'écran. Cliquez sur une pour choisir une couleur, et elle sera utilisée par l'outil en cours. (Par ex. l'outil "Peindre" utilisera cette couleur pour dessiner avec le piceau choisi, et l'outil "Remplir" utilisera cette couleur pour remplir une partie du dessin)
-
+
+

+
-
Tout à fait à droite se trouvent trois options spéciales pour les couleurs :
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Par exemple : Choisis une forme. Clique pour démarrer le dessin , fais glisser et continue jusqu'à la taille désirée. Déplace-toi pour la faire tourner, et clique pour dessiner.)">
+
-
diff --git a/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt b/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt
index a052ce9bc..a7fcdeb1f 100644
--- a/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Guide de démarrage rapide 0.9.34 pour Tux Paint
-Outils (dessin)
+ ### Outils (dessin) ###
-🖌Peindre
+## 🖌Peindre ##
* Choisissez un pinceau sur la droite.
* Certains pinceaux sont animés 🎞, d'autres directionnels ✲, certains ont les
@@ -12,7 +12,7 @@ Outils (dessin)
* Choisir une couleur (voir "Couleurs").
* Cliquez/tapez et promenez-vous sur le canevas pour peindre.
-⌧Tampons
+## ⌧Tampons ##
* Changez de catégories avec les flèches ⇦⇨ en bas à droite..
* Choisisez un tampon sur la droite.
@@ -30,12 +30,12 @@ Outils (dessin)
* Quelques tampons ont des sons descriptifs; pressez sur le bouton des
écouteurs 🎧 pour réentendre.
-⚟Lignes
+## ⚟Lignes ##
* (Voir Peindre)
* Cliquez/tapez puis balayez pour tracer une ligne.
-⭓Formes
+## ⭓Formes ##
* Choisissez une forme sur la droite.
* Choisissez si vous voulez étendre la forme à partir du centre ⧈, ou à
@@ -44,7 +44,7 @@ Outils (dessin)
forme.
* Balayez pour tourner, puis cliquez/tapez pur l'ajouter au dessin.
-🄰Texte
+## 🄰Texte ##
* Choisissez une fonte sur la droite.
* Choisissez si vous voulez que le texte soit en gras 𝗔 et/ou en italique 𝘈,
@@ -66,7 +66,7 @@ Outils (dessin)
+ Les flèches gauche/droite permet la bascule entre des dispositions de
clavier (par ex."QWERTY" vs. "ABC")
-🅰Étiquette
+## 🅰Étiquette ##
* (Voir texte)
* Les étiquettes flottent 'au dessus' du dessin; vous ne pouvez pas peindre
@@ -81,7 +81,7 @@ Outils (dessin)
en l'appliquant sur le canevas; on ne pourra plus l'éditer avec l'outil
étiquette.
-🪣Remplir
+## 🪣Remplir ##
* Choisissez un mode de remplissage sur la droite.
* Choisir une couleur (voir "Couleurs").
@@ -97,7 +97,7 @@ Outils (dessin)
+ Mis en forme - Remplit la surface avec une gradation qui suit les
contours de la surface à remplir
-🪄Magie
+## 🪄Magie ##
* Choisissez un outil magique sur la droite.
* Changez de catégories avec les flèches ⇦⇨ en bas à droite..
@@ -108,26 +108,26 @@ Outils (dessin)
📶 en bas à droite.
* Certains outils magiques vous permettent de choisir leur couleur.
-🖓Défaire
+## 🖓Défaire ##
* Utilisez pour annuler les actions récentes (peut être répété).
* Shortcut: [Control]+[Z]
-🖒Refaire
+## 🖒Refaire ##
* Utilisez pour refaire des actions annulées (peut être répété).
* Shortcut: [Control]+[R]
-◪Gomme
+## ◪Gomme ##
* Choisissez la taille et la forme de la gomme sur la droite.
* Cliquez/tapez et balayez pour effacer des parties de l'image (couleur unie,
ou image de démarrage ou modèle).
* Raccourci : [X] et cliquez/tapez sur le dessin (pas toujours disponible)
-Outils (Contrôles)
+ ### Outils (Contrôles) ###
-🗏Nouveau
+## 🗏Nouveau ##
* Choisissez une couleur unie, une image de démarrage ou une image modèle
pour commencer.
@@ -141,7 +141,7 @@ Outils (Contrôles)
* Cliquez/tapez "⤺Back" pour annuler et revenir à votre dessin en cours.
* Shortcut: [Control]+[N]
-🕮⮫Ouvrir
+## 🕮⮫Ouvrir ##
* Choisissez un dessin déjà sauvegardé pour l'ouvrir (ou pour l'exporter ou
l'effacer).
@@ -166,7 +166,7 @@ Outils (Contrôles)
modèle.
* Shortcut: [Control]+[O]
-🕮⮪Sauvegarder
+## 🕮⮪Sauvegarder ##
* Cliquez/Tapez pour sauvegarder votre dessin.
* Si vous aviez déjà sauvegardé, on vous demandera si on écrase la précédente
@@ -174,19 +174,19 @@ Outils (Contrôles)
sauvegarde (avec "Fichier - Sauvegarder comme ..")
* Shortcut: [Control]+[S]
-🖶Imprimer
+## 🖶Imprimer ##
* Cliquez/tapez pour imprimer votre dessin.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Quitter
+## 🗙Quitter ##
* Cliquer/Taper pour quitter Tux Paint.
* Shortcut: [Escape]
-Couleurs
+ ### Couleurs ###
* Cliquez/tapez pour choisir une couleur à utiliser pour les outils Peindre,
Lignes et Formes, et les Tampons et outils Magie qui fonctionnent avec des
@@ -214,7 +214,7 @@ Couleurs
+ Cliquez/tapez sur "⤺Back" pour annuler et abandonner le mélangeur de
couleur.
-Raccourcit quand on dessine :
+ ### Raccourcit quand on dessine : ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Cliquez/tapez - accès rapide à la gomme ◪
diff --git a/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index 9b495c379..2ce124154 100644
--- a/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+-------------------------------------------+
-------------------------------------------------------------------------------
-Sobre este «Como facelo»
+ ### Sobre este «Como facelo» ###
Este «Como facelo» supón que quere facer un excelente selo de Tux Paint, en
formato PNG con mapa de bits, a partir dunha imaxe JPEG (p. ex.: unha
@@ -34,9 +34,9 @@ Sobre este «Como facelo»
-------------------------------------------------------------------------------
-A elección da imaxe é crucial
+ ### A elección da imaxe é crucial ###
- Licenza
+ ## Licenza ##
Se quere enviar ilustracións aos desenvolvedores de Tux Paint para a
súa inclusión no proxecto oficial, ou se quere publicar a súa propia
@@ -58,7 +58,7 @@ A elección da imaxe é crucial
Para uso persoal, calquera imaxe que lexitimamente poida modificar e
usar para o seu uso persoal debería estar ben.
- Tamaño e orientación da imaxe
+ ## Tamaño e orientación da imaxe ##
Precisa unha imaxe que teña unha orientación útil. A perspectiva é un
inimigo. As imaxes que obxecto un obxecto dende un canto son difíciles
@@ -88,7 +88,7 @@ A elección da imaxe é crucial
-------------------------------------------------------------------------------
-Preparar a imaxe
+ ### Preparar a imaxe ###
Primeiro de todo, asegúrese de evitar gardar de novo a imaxe como JPEG.
Isto provoca unha perda de calidade. Hai unha ferramenta especial chamada
@@ -125,7 +125,7 @@ Preparar a imaxe
-------------------------------------------------------------------------------
-Preparar a máscara
+ ### Preparar a máscara ###
Acostúmese a facer [Control]-premer e [Alt]-premer nas imaxes en miniatura
no diálogo de capas. Necesitará isto para controlar o que está a ver e o
@@ -186,7 +186,7 @@ Preparar a máscara
-------------------------------------------------------------------------------
-Substituír a franxa e os píxeles lixo
+ ### Substituír a franxa e os píxeles lixo ###
Se sigue a ver a máscara, seleccione por cor. Escolla o negro. Reduza a
selección en varios píxeles, asegurándose de NON reducir os bordos da
@@ -250,7 +250,7 @@ Substituír a franxa e os píxeles lixo
-------------------------------------------------------------------------------
-Gardar a imaxe para Tux Paint
+ ### Gardar a imaxe para Tux Paint ###
É moi doado esnaquizar un traballo arreo. Os editores de imaxes poden
esnaquizar silenciosamente píxeles en áreas 0% opacas. As condicións nas
@@ -261,7 +261,7 @@ Gardar a imaxe para Tux Paint
súa imaxe para aforrar espazo (e agochar os seus erros), é case seguro que
destruirá todas as áreas 0% opacas. Velaquí unha mellor forma...
- Un xeito máis seguro de gardar
+ ## Un xeito máis seguro de gardar ##
Arrastre a máscara desde o diálogo de capas ata a parte non utilizada
da barra de ferramentas (xusto após a última ferramenta de debuxo).
diff --git a/docs/gl_ES.UTF-8/ENVVARS.txt b/docs/gl_ES.UTF-8/ENVVARS.txt
index 376b9576e..b988ac3bd 100644
--- a/docs/gl_ES.UTF-8/ENVVARS.txt
+++ b/docs/gl_ES.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou
indirectamente polas bibliotecas que emprega.
-Variábeis de contorno relacionadas co almacenamento
+ ### Variábeis de contorno relacionadas co almacenamento ###
-HOME
+→ HOME ←
Especifica o «directorio persoal» do usuario, que se usa para localizar
outros ficheiros ou directorios. Nalgúns casos, úsase como parte dunha
@@ -31,8 +31,8 @@ HOME
+ A localización da colección privada de ficheiros de datos dun usuario —
selos, pinceis, etc. — (fronte aos dispoñíbeis no sistema)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@@ -43,8 +43,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@@ -54,19 +54,19 @@ XDG_DATA_HOME
anywhere.
-
-TEMP
+
+→ TEMP ←
Especifica a localización onde se poden crear ficheiros temporais. Só o usa
Tux Paint nos sistemas operativos Microsoft Windows. Emprega «userdata» se
non se define.
-Variábeis de contorno relacionadas co idioma
+ ### Variábeis de contorno relacionadas co idioma ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -75,16 +75,16 @@ LC_MESSAGES
and finally "LANG".
+
-
-Variábeisbles de contorno relacionadas co que se amosa
+ ### Variábeisbles de contorno relacionadas co que se amosa ###
A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple
DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar gráficos,
reproducir sons e recibir entrada do rato, teclado e joystick — e que poden ser
útiles para os usuarios de Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Especifica se Tux Paint debería permitir a execución dun protector de
pantalla. Pode ser definido como «1» (verdadeiro) polo propio Tux Paint
@@ -92,8 +92,8 @@ SDL_VIDEO_ALLOW_SCREENSAVER
no ficheiro de configuración.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@@ -102,5 +102,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").
-
+
diff --git a/docs/gl_ES.UTF-8/EXTENDING.txt b/docs/gl_ES.UTF-8/EXTENDING.txt
index aa4c5e822..596e50012 100644
--- a/docs/gl_ES.UTF-8/EXTENDING.txt
+++ b/docs/gl_ES.UTF-8/EXTENDING.txt
@@ -45,11 +45,11 @@ busque Tux Paint.
Onde van os ficheiros
-Ficheiros estándar
+ ### Ficheiros estándar ###
Tux Paint busca os seus diferentes ficheiros de datos no directorio «data».
-Linux e Unix
+→ Linux e Unix ←
Onde vai este directorio depende do valor estabelecido para «DATA_PREFIX»
cando se construíu Tux Paint. Vexa a «Documentación de instalación» para
@@ -64,8 +64,8 @@ Linux e Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint busca un directorio chamado «data» no mesmo directorio que o
executábel. Este é o directorio que utilizou o instalador ao instalar Tux
@@ -74,8 +74,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint almacena os seus ficheiros de datos dentro da icona da aplicación
«Tux Paint» (que en realidade é un tipo de cartafol especial en macOS e Mac
@@ -110,15 +110,15 @@ macOS
os usuarios de Tux Paint.
+
-
-Ficheiros persoais
+ ### Ficheiros persoais ###
Tamén pode crear pinceis, selos, «imaxes de comezo», modelos e tipos de letra
no directorio da súa propia conta de usuario (cartafol) para que Tux Paint
poida atopalos.
-Windows
+→ Windows ←
O seu cartafol persoal de Tux Paint almacénase nos seus «Datos da
aplicación» persoais. Por exemplo, nos Windows máis recentes:
@@ -126,8 +126,8 @@ Windows
C:\Users\nome de usuario\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -135,8 +135,8 @@ macOS
/Users/nome de usuario/Library/Application Support/TuxPaint/
-
-Linux e Unix
+
+→ Linux e Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/nome de usuario/.tuxpaint/".
@@ -144,7 +144,7 @@ Linux e Unix
Non esqueza o punto («.») antes de «tuxpaint»!
-
+
Para engadir os seus propios pinceis, selos, «imaxes de comezo», modelos e
tipos de letra, cree subdirectorios no seu directorio persoal de Tux Paint
@@ -166,7 +166,7 @@ transparente.
Os píxeles de escala de grises no pincel PNG debuxaranse empregando a cor
seleccionada actualmente en Tux Paint. Os píxeles de cor tinguiranse.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -176,7 +176,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Compatibilidade da localización
+→ Compatibilidade da localización ←
Pódense engadir liñas adicionais ao ficheiro de texto para fornecer
traducións da descrición, que se amosarán cando Tux Paint estea a
@@ -197,17 +197,17 @@ Compatibilidade da localización
Paint, utilízase o texto en inglés dos EUA.
-
-Usuarios de Windows
+
+→ Usuarios de Windows ←
Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de
gardalos como texto simple e asegúrese de que teñen unha extensión «.txt»
ao final do nome do ficheiro.
+
-
-Opcións de pinceis
+ ### Opcións de pinceis ###
Ademais de a graphical shape, a brushes tamén se lle poden dar outros
atributos. Para facelo, cómpre crear un «ficheiro de datos» para brush.
@@ -219,7 +219,7 @@ O ficheiro ten o mesmo nome que a imaxe PNG, pero unha extensión «.dat». (p.
ex.: o ficheiro de datos de «pincel.png» é o ficheiro de texto «pincel.dat»,
que se atopa no mesmo directorio.)
-Espazado do pincel
+→ Espazado do pincel ←
A partir da versión 0.9.16 de Tux Paint, agora pode especificar o espazado
para os pinceis (é dicir, a frecuencia coa que se debuxan). De xeito
@@ -230,8 +230,8 @@ Espazado do pincel
número, máis veces se debuxa o pincel.)
-
-Pinceis animados
+
+→ Pinceis animados ←
A partir da versión 0.9.16 de Tux Paint, pode crear pinceis animados. A
medida que se usa o pincel, debúxase cada cadro da animación.
@@ -246,8 +246,8 @@ Pinceis animados
sequentially, also add a line containing "random" to the brush's data file.
-
-Pinceis direccionais
+
+→ Pinceis direccionais ←
A partir da versión 0.9.16 de Tux Paint, pode crear pinceis direccionais. A
medida que se usa o pincel, debúxanse diferentes formas, dependendo da
@@ -263,8 +263,8 @@ Pinceis direccionais
debrush's.
-
-Rotating Brushes
+
+→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@@ -274,8 +274,8 @@ Rotating Brushes
debrush's.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -284,8 +284,8 @@ Chaotic Brushes
debrush's.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -299,7 +299,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Coloque os ficheiros PNG de pincel (e calquera ficheiro de texto de datos) no
directorio «brushes».
@@ -315,7 +315,7 @@ crear alí subdirectorios e subsubdirectorios para organizar os selos. (Por
exemplo, pode ter un cartafol «vacacións» con subcartafoles «samaín» e
«nadal»).
-Imaxes de selos
+ ### Imaxes de selos ###
Os selos de caucho en Tux Paint poden estar formados por varios ficheiros
separados. O único ficheiro necesario é, por suposto, a imaxe en si.
@@ -345,7 +345,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
detalladamente como facer imaxes PNG que se adaptarán perfectamente cando se
usen como selos en Tux Paint.
-Texto descritivo do selo
+ ### Texto descritivo do selo ###
Tux Paint amosará texto descritivo cando se seleccione un selo. Estes colócanse
en ficheiros de texto sinxelo co mesmo nome que PNG ou SVG, pero cunha
@@ -355,7 +355,7 @@ almacénase en «selo.txt» no mesmo directorio.)
A primeira liña do ficheiro de texto usarase como a descrición da imaxe do selo
en inglés dos EUA. Debe estar codificado en UTF-8.
-Compatibilidade da localización
+→ Compatibilidade da localización ←
Pódense engadir liñas adicionais ao ficheiro de texto para fornecer
traducións da descrición, que se amosarán cando Tux Paint estea a
@@ -375,17 +375,17 @@ Compatibilidade da localización
Paint, utilízase o texto en inglés dos EUA.
-
-Usuarios de Windows
+
+→ Usuarios de Windows ←
Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de
gardalos como texto simple e asegúrese de que teñen unha extensión «.txt»
ao final do nome do ficheiro.
+
-
-Efectos de son dos selos
+ ### Efectos de son dos selos ###
Tux Paint pode reproducir un efecto de son cando se selecciona un selo. Por
exemplo, o son dun pato tremendo cando se selecciona un pato ou unha breve peza
@@ -394,7 +394,7 @@ formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» e reciben o mesmo nome que
imaxe PNG ou SVG. (p. ex.: o efecto de son de «selo.svg» é o ficheiro de son
«selo.ogg» no mesmo directorio.)
-Compatibilidade da localización
+→ Compatibilidade da localización ←
Para sons para distintos idiomas (p. ex.: se o son é alguén que di unha
palabra e quere versións traducidas da palabra dita), cree tamén ficheiros
@@ -411,12 +411,12 @@ Compatibilidade da localización
ficheiro de son «predeterminado». (por exemplo, «selo.wav»)
-
+
💡 Note: Also consider using descriptive sounds; see 'Son descritivo do selo',
below.
-Son descritivo do selo
+ ### Son descritivo do selo ###
Tux Paint tamén pode reproducir un son descritivo cando se selecciona un selo.
Por exemplo, o son de alguén que di a palabra «pato» cando selecciona un pato
@@ -425,7 +425,7 @@ en formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» e reciben o mesmo nome
a imaxe PNG ou SVG, con «_desc» ao final. (p. ex.: o son descritivo de
«selo.svg» é o ficheiro de son «selo_desc.ogg» no mesmo directorio.)
-Compatibilidade da localización
+→ Compatibilidade da localización ←
Para sons descritivos de diferentes idiomas, cree tamén ficheiros WAV ou
OGG con ambos «_desc» e a etiqueta local no nome do ficheiro, na forma:
@@ -441,9 +441,9 @@ Compatibilidade da localización
ficheiro de son «predeterminado». (por exemplo, «selo_desc.wav»)
+
-
-Opcións de selos
+ ### Opcións de selos ###
Ademais de a graphical shape, a textual description, a sound effect, and a
descriptive sound, a stamps tamén se lle poden dar outros atributos. Para
@@ -456,11 +456,11 @@ O ficheiro ten o mesmo nome que a imaxe PNG or SVG, pero unha extensión «.dat
(p. ex.: o ficheiro de datos de «selo.png» é o ficheiro de texto «selo.dat»,
que se atopa no mesmo directorio.)
-Selos de cores
+→ Selos de cores ←
Os selos pódense facer «colorábeis» ou «tinguíbeis».
- Colorábel
+ → Colorábel ←
Os selos «colorábeis» funcionan como os pinceis: escolla o selo para
obter a forma e logo escolla a cor que quere que sexa. (Os selos de
@@ -473,8 +473,8 @@ Selos de cores
destamp's.
-
- Tinguido
+
+ → Tinguido ←
Os selos «tinguidos» son semellantes aos «colorábeis», agás que se
conservan os detalles da imaxe orixinal. (Para dicilo tecnicamente,
@@ -485,14 +485,14 @@ Selos de cores
destamp's.
-
- Opcións de tintura:
+
+ → Opcións de tintura: ←
Dependendo do contido do seu selo, é posíbel que queira que Tux Paint
use un dos varios métodos para tinguilo. Engada unha das seguintes
liñas ao ficheiro de datos do selo:
- Tinguido normal — "tinter=normal" (o predeterminado)
+ → Tinguido normal — "tinter=normal" (o predeterminado) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@@ -503,29 +503,29 @@ Selos de cores
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
-
- Tinguido estreito — "tinter=narrow"
+
+ → Tinguido estreito — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- Tinguir de «calquera tonalidade» — "tinter=anyhue"
+
+ → Tinguir de «calquera tonalidade» — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Tinguido vectorial — "tinter=vector"
+
+ → Tinguido vectorial — "tinter=vector" ←
Isto asigna de «negro a través branco» a «negro a través do
destino».
+
+
-
-
-
-Selos inalterábeis
+
+→ Selos inalterábeis ←
De xeito predeterminado, un selo pode inverter (poñer do revés), amosarse
como unha imaxe reflectida ou ámbalas dúas cousas. Isto faise usando os
@@ -543,8 +543,8 @@ Selos inalterábeis
opción «nomirror» no ficheiro de datos do selo.
-
-Tamaño inicial do selo
+
+→ Tamaño inicial do selo ←
De xeito predeterminado, Tux Paint asume que o seu selo ten o tamaño
axeitado para ser visto sen escala nun lenzo de 608x472. Este era o tamaño
@@ -563,17 +563,17 @@ Tamaño inicial do selo
+ "scale 2.5"
+ "scale 2:5"
-
-Usuarios de Windows
+
+→ Usuarios de Windows ←
Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de
gardalos como texto simple e asegúrese de que teñen unha extensión «.dat»
ao final do nome do ficheiro.
+
-
-Selos prereflectidos e invertidos
+ ### Selos prereflectidos e invertidos ###
Nalgúns casos, pode que queira fornecer unha versión deseñada previamente da
imaxe reflectida, da imaxe invertida ou incluso de ámbalas dúas. Por exemplo,
@@ -615,7 +615,7 @@ Cando usa unha imaxe «de inicio», fai modificacións e a garda, a imaxe «de
inicio» orixinal non se sobreescribe. Ademais, ao editar a súa nova imaxe, o
contido da imaxe «de inicio» orixinal pode afectala.
-Imaxes «de comezo» ao estilo dun libro para colorar
+ ### Imaxes «de comezo» ao estilo dun libro para colorar ###
O tipo máis básico de imaxe «de inicio» é semellante a unha imaxe dun libro
para colorar. É un esquema dunha forma que logo pode colorar e engadir
@@ -629,7 +629,7 @@ ou SVG vectorial. Se o garda como PNG, opcionalmente pode renderizar a imaxe en
negro e transparente no canto de en branco e negro, mais (a partir do Tux Paint
0.9.21) isto non é necesario.
-Imaxes «de comezo» ao estilo dunha escena
+ ### Imaxes «de comezo» ao estilo dunha escena ###
Xunto coa superposición de estilo «libro para colorar», tamén pode fornecer
unha imaxe de fondo separada como parte dunha imaxe «de inicio». A
@@ -670,7 +670,7 @@ Paint has been quit, or another picture is loaded or a new image is created.
(In other words, if you base a drawing on a imaxe «de comezo», it will always
be affected by it.)
-Starter Options
+ ### Starter Options ###
Ademais de an image, a starters tamén se lle poden dar outros atributos. Para
facelo, cómpre crear un «ficheiro de datos» para starter. (Note: Tux Paint
@@ -683,7 +683,7 @@ O ficheiro ten o mesmo nome que a imaxe , pero unha extensión «.dat». (p. ex.
o ficheiro de datos de «starter.png» é o ficheiro de texto «starter.dat», que
se atopa no mesmo directorio.)
-allowscale
+→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@@ -722,8 +722,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
-
-background
+
+→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@@ -742,8 +742,8 @@ background
details.
-
-gravity
+
+→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@@ -767,6 +767,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
+
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@@ -774,6 +775,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
+
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@@ -781,12 +783,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
+
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
+
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@@ -794,13 +798,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
+
Focusing on the right of a starter image stretched to fit the height of the
canvas.
-
+
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@@ -842,7 +847,7 @@ or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a imaxe «modelo», it will always be affected by it.)
-Template Options
+ ### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@@ -988,7 +993,7 @@ diferentes deseños).
Usaremos o teclado QWERTY como exemplo:
-Ficheiro de visión xeral da disposición («qwerty.layout»)
+ ### Ficheiro de visión xeral da disposición («qwerty.layout») ###
Este é un ficheiro de texto que especifica os outros ficheiros empregados para
describir a disposición e as asignacións de teclas.
@@ -1006,7 +1011,7 @@ seen in the example above.
A liña «keyboardlist» describe a que esquemas cambiar, cando o usuario preme
nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.)
-Ficheiro de disposición do teclado («qwerty.h_layout»)
+ ### Ficheiro de disposición do teclado («qwerty.h_layout») ###
Isto describe o tamaño do teclado (como unha reixa de «largo × alto») e lista
cada tecla co seu código numérico (ver o ficheiro «keymap», máis abaixo), o
@@ -1073,7 +1078,7 @@ actualmente descríbense a continuación.
* 2 — disposición anterior (segundo o axuste «keyboardlist» do ficheiro de
disposición)
-Ficheiro do mapa do teclado («us-intl-altgr-dead-keys.keymap»)
+ ### Ficheiro do mapa do teclado («us-intl-altgr-dead-keys.keymap») ###
Este ficheiro define que códigos das teclas numéricas (vistos nos ficheiros de
disposición de teclado, como «qwerty.h_layout» descrito anteriormente) deben
@@ -1113,7 +1118,7 @@ dispoñíbel a ferramenta de liña de ordes «xmodmap», pode executala coa opci
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Ficheiro do mapa de composición («en_US.UTF-8_Compose»)
+ ### Ficheiro do mapa de composición («en_US.UTF-8_Compose») ###
Este ficheiro describe caracteres individuais que poden ser compostos por
varias entradas. Por exemplo, pódese usar «[Composición]» seguido de «[A]» e «
@@ -1124,7 +1129,7 @@ O ficheiro que vén con Tux Paint está baseado no mapa de composición UTF-8
actual da biblioteca Xlib dispón dunha páxina en https://www.x.org/releases/
current/doc/libX11/i18n/compose/en_US.UTF-8.html.
-Ficheiro de definición Keysym («keysymdef.h»)
+ ### Ficheiro de definición Keysym («keysymdef.h») ###
Este ficheiro (que é un ficheiro de cabeceira da linguaxe de programación C)
tamén é do Sistema X Window. Define os valores Unicode de cada tecla (p. ex.:
diff --git a/docs/gl_ES.UTF-8/FAQ.txt b/docs/gl_ES.UTF-8/FAQ.txt
index eb6e1484d..e4055626d 100644
--- a/docs/gl_ES.UTF-8/FAQ.txt
+++ b/docs/gl_ES.UTF-8/FAQ.txt
@@ -21,16 +21,16 @@
+--------------------------------------------+
-------------------------------------------------------------------------------
-Relacionado co debuxo
+ ### Relacionado co debuxo ###
-Os tipos de letra que engadín a Tux Paint só amosan cadrados
+→ Os tipos de letra que engadín a Tux Paint só amosan cadrados ←
O tipo de letra TrueType que está a usar pode ter unha codificación
incorrecta. Se está codificado «personalizado», por exemplo, pode tentar
executalo a través de FontForge (http://fontforge.sourceforge.net/) para
convertelo a un formato ISO-8859. (Envíanos un correo electrónico se
precisas axuda con tipos de letra especiais.)
-
-A ferramenta «Selo de caucho» está gris.
+
+→ A ferramenta «Selo de caucho» está gris. ←
Isto significa que Tux Paint non atopou ningunha imaxe de selo ou se lle
pediu que non as cargase.
@@ -57,8 +57,8 @@ A ferramenta «Selo de caucho» está gris.
configuración.
-
-Os contornos do selo son sempre rectángulos
+
+→ Os contornos do selo son sempre rectángulos ←
Tux Paint foi compilado con contornos de selo de baixa calidade (pero máis
rápidos).
@@ -71,13 +71,13 @@ Os contornos do selo son sempre rectángulos
no ficheiro «tuxpaint.c» no directorio «src».
-
+
-------------------------------------------------------------------------------
-Problemas de interface
+ ### Problemas de interface ###
-As miniaturas dos selos no selector de selos vense mal
+→ As miniaturas dos selos no selector de selos vense mal ←
Probabelmente Tux Paint foi compilado co código de miniaturas máis
rápidoase de menor calidade activado. Executa a orde «tuxpaint
@@ -92,24 +92,24 @@ As miniaturas dos selos no selector de selos vense mal
no ficheiro «tuxpaint.c» no directorio «src».
-
-As imaxes do diálogo «Abrir» vense mal
+
+→ As imaxes do diálogo «Abrir» vense mal ←
Probabelmente estea activada a opción «Miniaturas de baixa calidade». Vexa:
«As miniaturas dos selos no selector de selos vense mal», arriba.
-
-Todo o texto está en maiúscula.
+
+→ Todo o texto está en maiúscula. ←
Está activada a opción «maiúsculas».
Cambie ou elimine a opción «uppercase» ou pode anulala con «--mixedcase» na
liña de ordes ou con «uppercase=no» ou »mixedcase=yes» nun ficheiro de
configuración.
-
-Tux Paint está noutro idioma
+
+→ Tux Paint está noutro idioma ←
Asegúrese de que os seu axuste da configuración local sexa correcto. Vexa
«Tux Paint non cambia ao meu idioma», a continuación.
-
-Tux Paint non cambia ao meu idioma
+
+→ Tux Paint non cambia ao meu idioma ←
+ Usuarios de Linux e Unix: asegúrese de que a configuración local está
dispoñíbel
@@ -151,13 +151,13 @@ Tux Paint non cambia ao meu idioma
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Impresión
+ ### Impresión ###
-Tux Paint non imprime, produce un erro ou imprime lixo (Unix/Linux)
+→ Tux Paint non imprime, produce un erro ou imprime lixo (Unix/Linux) ←
Tux Paint imprime creando unha representación PostScript da imaxe e
enviándoa a unha orde externa. De xeito predeterminado, esta orde é a
@@ -176,8 +176,8 @@ Tux Paint non imprime, produce un erro ou imprime lixo (Unix/Linux)
que volver atras e modificala para que acepte PostScript.
-
-Recibo a mensaxe «Aínda non pode imprimir» cando vou imprimir
+
+→ Recibo a mensaxe «Aínda non pode imprimir» cando vou imprimir ←
A opción «atraso de impresión» está activada. Só pode imprimir unha vez
cada X segundos.
@@ -201,8 +201,8 @@ Recibo a mensaxe «Aínda non pode imprimir» cando vou imprimir
permitirá a impresión ilimitada. (Non terás aue agardar entre impresións).
-
-Simplemente non podo imprimir. O botón está gris.
+
+→ Simplemente non podo imprimir. O botón está gris. ←
A opción «non imprimir» está activada.
@@ -224,43 +224,43 @@ Simplemente non podo imprimir. O botón está gris.
«Impresión») está marcado.
-
+
-------------------------------------------------------------------------------
-Gardar
+ ### Gardar ###
-Onde garda Tux Paint os meus debuxos?
+→ Onde garda Tux Paint os meus debuxos? ←
A non ser que lle solicite a Tux Paint que garde nun lugar específico
(usando a opción «savedir»), Tux Paint garda nun lugar estándar na súa
unidade local:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\nome de usuario\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g.,
"/Users/nome de usuario/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/nome de usuario/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
As imaxes almacénanse como mapas de bits PNG, que a maioría dos programas
modernos deberían poder cargar (editores de imaxes, procesadores de texto,
navegadores web, etc.)
-
-Tux Paint sempre garda sobre a miña imaxe antiga
+
+→ Tux Paint sempre garda sobre a miña imaxe antiga ←
A opción «save over» está activada. (Isto desactiva a pregunta que
aparecería ao premer en «Gardar»).
@@ -285,8 +285,8 @@ Tux Paint sempre garda sobre a miña imaxe antiga
Ademais, vexa «Tux Paint sempre garda unha nova imaxe», a continuación.
-
-Tux Paint sempre garda unha nova imaxe.
+
+→ Tux Paint sempre garda unha nova imaxe. ←
A opción «never save over» está activada. (Isto desactiva a pregunta que
aparecería ao premer en «Gardar»).
@@ -311,13 +311,13 @@ Tux Paint sempre garda unha nova imaxe.
Also, see "Tux Paint always saves over my old picture!", above.
-
+
-------------------------------------------------------------------------------
-Problemas de son
+ ### Problemas de son ###
-Non hai son.
+→ Non hai son. ←
+ Primeiro, comprobe o obvio:
o Están conectados e acendidos os altofalantes?
o Subiu o volume dos altofalantes?
@@ -379,8 +379,8 @@ Non hai son.
súas cabeceiras de desenvolvemento están dispoñíbeis.
-
-Tux Paint fai moito ruído. Podo apagalo?
+
+→ Tux Paint fai moito ruído. Podo apagalo? ←
Si, hai varias formas de desactivar os sons en Tux Paint:
@@ -398,9 +398,9 @@ Tux Paint fai moito ruído. Podo apagalo?
o Como alternativa, recompile Tux Paint coa compatibilidade de son
desactivada. (Vexa máis arriba e a documentación «Instalar».
-
-A panorámica estéreo dos efectos de son é molesta; os efectos de son poden ser
- monofónicos?
+
+→ A panorámica estéreo dos efectos de son é molesta; os efectos de son poden
+ ser monofónicos? ←
Execute Tux Paint coa opción «sen estéreo»:
@@ -412,8 +412,8 @@ A panorámica estéreo dos efectos de son é molesta; os efectos de son poden se
+ Ou use Tux Paint Config. e asegúrese de «Activar os efectos estéreo»
(baixo «Vídeo e son») non está marcado.
-
-Os efectos de son soan estraños
+
+→ Os efectos de son soan estraños ←
Isto podería ter que ver con como se inicializaron SDL e SDL_mixer. (O
tamaño do búfer escollido.)
@@ -423,17 +423,17 @@ Os efectos de son soan estraños
executar (execute «tuxpaint --version» para verificar), etc.)
-
+
-------------------------------------------------------------------------------
-Problemas no modo de pantalla completa
+ ### Problemas no modo de pantalla completa ###
-Cando executo Tux Paint a pantalla completa e [Alt] + [Tab] está fóra, a xanela
- vólvese negra.
+→ Cando executo Tux Paint a pantalla completa e [Alt] + [Tab] está fóra, a
+ xanela vólvese negra. ←
Aparentemente é un erro na biblioteca SDL. Sentímolo.
-
-Cando executo Tux Paint a pantalla completa, ten grandes bordos ao redor
+
+→ Cando executo Tux Paint a pantalla completa, ten grandes bordos ao redor ←
Usuarios de Linux: o seu servidor X-Window probabelmente non estea
configurado coa capacidade de cambiar á resolución desexada: 800×600. (ou a
@@ -460,8 +460,9 @@ Cando executo Tux Paint a pantalla completa, ten grandes bordos ao redor
«dpkg-reconfigure xserver-xfree86» como superusuario (root), por exemplo.
-
-Tux Paint segue a funcionar en modo de pantalla completa e quéroo na xanela.
+
+→ Tux Paint segue a funcionar en modo de pantalla completa e quéroo na xanela.
+ ←
A opción «pantalla completa» está estabelecida.
@@ -484,20 +485,21 @@ Tux Paint segue a funcionar en modo de pantalla completa e quéroo na xanela.
son») non está marcado.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-
+
-------------------------------------------------------------------------------
-Other Problems
+ ### Other Problems ###
-Tux Paint non funciona
+→ Tux Paint non funciona ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -525,8 +527,8 @@ Tux Paint non funciona
configuración.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -548,8 +550,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-Non podo saír de Tux Paint
+
+→ Non podo saír de Tux Paint ←
Está estabelecida a opción «non saír». Isto desactiva o botón «Saír» na
barra de ferramentas de Tux Paint (marcándoo) e impide que se poida saír de
@@ -567,8 +569,8 @@ Non podo saír de Tux Paint
[Alt] + [F4] no teclado para saír de Tux Paint.)
-
-Non quero que se active o modo «non saír».
+
+→ Non quero que se active o modo «non saír». ←
Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non
está a pasarlle a opción «--noquit».
@@ -588,8 +590,9 @@ Non quero que se active o modo «non saír».
tecla [Escape]» (baixo «Simplificación») non está marcado.
-
-Tux Paint segue a escribir mensaxes estrañas na pantalla/nun ficheiro de texto
+
+→ Tux Paint segue a escribir mensaxes estrañas na pantalla/nun ficheiro de
+ texto ←
Algunhas mensaxes son normais, mais se Tux Paint está a ser extremadamente
detallado (como enumerar o nome de cada imaxe de selo de goma que atopa ao
@@ -604,8 +607,8 @@ Tux Paint segue a escribir mensaxes estrañas na pantalla/nun ficheiro de texto
no ficheiro «tuxpaint.c» no directorio «src».
-
-Tux Paint está a usar opcións que non especifiquei.
+
+→ Tux Paint está a usar opcións que non especifiquei. ←
De xeito predeterminado, Tux Paint primeiro mira os ficheiros de
configuración para ver as opcións.
@@ -687,11 +690,11 @@ Tux Paint está a usar opcións que non especifiquei.
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Axuda / Contacto
+ ### Axuda / Contacto ###
Hai algunha pregunta que non ve respondida? Agradecémoslle que nolo diga. Para
elo, pode subscribirse e publicar na nosa lista de correo «tuxpaint-users»:
diff --git a/docs/gl_ES.UTF-8/INSTALL.txt b/docs/gl_ES.UTF-8/INSTALL.txt
index e09d235d9..8b3f7ec00 100644
--- a/docs/gl_ES.UTF-8/INSTALL.txt
+++ b/docs/gl_ES.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Requirements
-Simple DirectMedia Layer library (libSDL)
+ ### Simple DirectMedia Layer library (libSDL) ###
Tux Paint require a «Simple DirectMedia Layer Library (libSDL)», unha
biblioteca de programación multimedia de código aberto dispoñíbel baixo a
@@ -58,13 +58,13 @@ mantemento de paquetes como «apt» de Debian).
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Outras bibliotecas
+## Outras bibliotecas ##
Tux Paint tamén aproveita outras bibliotecas libres con licenza LGPL. En Linux,
do mesmo xeito que SDL, deberían estar xa instaladas ou estar dispoñíbeis para
a súa instalación como parte da súa distribución de Linux.
-libPNG
+→ libPNG ←
Tux Paint utiliza o formato PNG (Portable Network Graphics – Gráficos de
Rede Portátiles) para os seus ficheiros de datos. A imaxe SDL requirirá a
@@ -73,8 +73,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint utiliza a configuración local do sistema xunto coa biblioteca
«gettext» para admitir varios idiomas (p. ex., o español). Necesitará ter a
@@ -83,8 +83,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Só Linux/Unix)
+
+→ libpaper (Só Linux/Unix) ←
A partir de Tux Paint 0.9.17, Tux Paint pode determinar o tamaño de papel
predeterminado do seu sistema (p. ex.: A4 ou Carta), ou pódeselle indicar
@@ -93,8 +93,8 @@ libpaper (Só Linux/Unix)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
As ferramentas «Texto» e «Etiqueta» de Tux Paint admiten linguaxes
bidireccionais grazas á biblioteca «FriBiDi».
@@ -102,32 +102,32 @@ FriBiDi
http://fribidi.org/
-
-Compatibilidade de SVG
+
+→ Compatibilidade de SVG ←
A partir de Tux Paint 0.9.17, Tux Paint pode cargar imaxes SVG (Scalable
Vector Graphics — Gráficos Vectoriais Escalábeis) como selos. Admítense
dous conxuntos de bibliotecas e pódese desactivar completamente a
compatibilidade SVG (a través de «make SVG_LIB:=»)
- librsvg-2 & libCairo2 (bibliotecas máis recentes)
+ → librsvg-2 & libCairo2 (bibliotecas máis recentes) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o Estes tamén dependen do seguinte:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Bibliotecas SVG máis antigas
+
+ → Bibliotecas SVG máis antigas ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o Estes tamén dependen do seguinte:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Función de exportación de GIF animado
+
+→ Función de exportación de GIF animado ←
Para a compatibilidade da exportación de GIF animados (presentacións de
diapositivas), é necesaria a biblioteca «libimagequant» (do proxecto
@@ -136,8 +136,8 @@ Función de exportación de GIF animado
https://github.com/ImageOptim/libimagequant
-
-Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado
+
+→ Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado ←
📜 En Linux e Unix, as versións anteriores de Tux Paint utilizaban as
ferramentas NetPBM para axudar á impresión. (Tux Paint xera un PNG e
@@ -147,7 +147,7 @@ Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado
http://netpbm.sourceforge.net/
-
+
Compiling and Installation
@@ -157,11 +157,11 @@ está dispoñíbel libremente.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
10 de Xullo de 2022 Shin-ichi TOYAMA
-Compiling Set-Up
+## Compiling Set-Up ##
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «Makefile»
inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS (
@@ -171,7 +171,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -199,7 +199,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@@ -210,7 +210,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -224,7 +224,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -256,7 +256,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@@ -267,7 +267,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -281,7 +281,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -308,7 +308,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -330,7 +330,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -340,7 +340,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -368,7 +368,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -396,7 +396,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Building the Tux Paint Windows Installer
+## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -418,7 +418,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Running the Tux Paint Windows Installer
+## Running the Tux Paint Windows Installer ##
Faga dobre clic no executábel do instalador de Tux Paint (ficheiro .EXE) e siga
as instrucións.
@@ -436,7 +436,7 @@ lugar diferente.
Neste punto, pode premer en «Instalar» para instalar Tux Paint.
-Changing the Settings Using the Shortcut
+## Changing the Settings Using the Shortcut ##
Para cambiar os axustes do programa, prema co botón dereito no atallo de
TuxPaint e seleccione «Propiedades» (na parte inferior).
@@ -464,7 +464,7 @@ botón «Aplicar»).
Cando teña rematado, prema en «Aceptar».
-If Something Goes Wrong
+## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -478,9 +478,9 @@ e minúsculas incorrectas (maiúsculas «Z» no canto de minúsculas «z») ou a
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compilación:
+## Compilación: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -491,8 +491,8 @@ orde dende un indicador do sistema (p. ex.: «$»):
$ make
-Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de
-«Cairo, libSVG, e svg-cairo»:
+## Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de
+«Cairo, libSVG, e svg-cairo»: ##
Para desactivar a compatibilidade con SVG (por exemplo, se o seu sistema non é
compatíbel coa biblioteca de Cairo ou outras dependencias relacionadas co SVG),
@@ -500,7 +500,7 @@ pode executar «make» engadindo «SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG»:
$ make SVG_LIB= SVG_CFLAGS=
-Disabling Sound at Compile-time
+## Disabling Sound at Compile-time ##
Se non te unha tarxeta de son ou prefire construír o programa sen asistencia de
son (e polo tanto sen a dependencia SDL_mixer), pode executar «make» con
@@ -508,12 +508,12 @@ son (e polo tanto sen a dependencia SDL_mixer), pode executar «make» con
$ make SDL_MIXER_LIB=
-Other options
+## Other options ##
Outras opcións (p. ex.: rutas de instalación) poden ser anuladas; véxaas en
«Makefile» para máis detalles.
-If you get errors
+## If you get errors ##
Se recibe algún erro durante o tempo de compilación, asegúrese de ter
instaladas as bibliotecas axeitadas (ver máis arriba). Se está a empregar
@@ -522,7 +522,7 @@ Debian), asegúrese de obter tamén os correspondentes paquetes «-dev» ou
«-devel», se non, non poderá compilar Tux Paint (e outros programas) dende o
código fonte.
-Installng
+## Installng ##
Supoñendo que non se produciron erros graves, agora pode instalar o programa
para que os usuarios do sistema poidan executalo. De xeito predeterminado, isto
@@ -550,7 +550,7 @@ Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Cambiar onde van as cousas
+# Cambiar onde van as cousas #
Pode cambiar onde irán as cousas axustando as variábeis de «Makefile» na liña
de ordes. «DESTDIR» úsase para colocar a saída nunha área de espera para a
@@ -559,49 +559,49 @@ e, de xeito predeterminado, está estabelecido en «/usr/local».
Outras variábeis son:
-BIN_PREFIX
+→ BIN_PREFIX ←
Onde se instalará o binario «tuxpaint». (Estabelécese como «$(PREFIX)/
bin»como predeterminado, p. ex.: «/usr/local/bin»)
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Onde irán os ficheiros de datos (son, gráficos, pinceis, selos, tipos de
letra) e onde os buscará Tux Paint cando se execute. (Estabelecer en «$
(PREFIX)/share/tuxpaint»)
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Onde irán os ficheiros de texto da documentación (o directorio «docs»).
(Estabelecer como «$(PREFIX)/share/doc/tuxpaint»)
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Onde irá a páxina do manual de Tux Paint. (Estabelecer como «$(PREFIX)/
share/man»)
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Onde irán as iconas e os lanzadores (para GNOME e KDE).
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Onde irán os ficheiros de tradución para Tux Paint e onde os buscará Tux
Paint. (Estabelécese en «$(PREFIX)/share/locale/») (A localización final
dun ficheiro de tradución estará no directorio da configuración local (por
exemplo, «es» para o español), dentro do subdirectorio «LC_MESSAGES»).
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
5 de Xuño de 2022 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Prerequisites
+## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -637,7 +637,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -649,7 +649,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -663,7 +663,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-How to Build
+## How to Build ##
Simply, run:
@@ -677,7 +677,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Known Issues
+## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -694,7 +694,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Old Versions of macOS
+## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -734,7 +734,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Recompiling MacPorts
+## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -758,7 +758,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Building a Universal Binary
+## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -772,7 +772,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
29 de Marzo de 2023 Pere Pujal i Carabantes (Edited by
Bill Kendrick)
@@ -781,7 +781,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Prerequisites
+## Prerequisites ##
You will need recent versions of:
@@ -806,7 +806,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Building
+## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -835,36 +835,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
7 de Maio de 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Prerequisites
+## Prerequisites ##
Install the required develop packages in Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Building
+## Building ##
make PREFIX=/boot/home/config/non-packaged
-Tux Paint Stamps
+## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -877,9 +878,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
-Windows
+ ### Windows ###
-Uso do desinstalador
+## Uso do desinstalador ##
Se instalou os atallos do menú Inicio (o predeterminado), vaia ao cartafol
TuxPaint e seleccione «Desinstalar». Amosarase unha caixa que confirmará que
@@ -888,12 +889,12 @@ permanentemente Tux Paint, prema no botón «Desinstalar».
Cando remate, prema no botón pechar.
-Usar o Panel de control
+## Usar o Panel de control ##
Tamén é posíbel usar a entrada «TuxPaint (só eliminar)« na sección Engadir/
Eliminar programas do Panel de control.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
@@ -901,7 +902,7 @@ the configuration files, stamps, and saved pictures, may be found in
"/Users/nome de usuario/Library/Application Support/TuxPaint/" (individual
users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/gl_ES.UTF-8/MAGIC-API.txt b/docs/gl_ES.UTF-8/MAGIC-API.txt
index 4473f8b72..86fa41b39 100644
--- a/docs/gl_ES.UTF-8/MAGIC-API.txt
+++ b/docs/gl_ES.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/gl_ES.UTF-8/OPTIONS.txt b/docs/gl_ES.UTF-8/OPTIONS.txt
index 2d4ee5c39..e71f97ab6 100644
--- a/docs/gl_ES.UTF-8/OPTIONS.txt
+++ b/docs/gl_ES.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
versión 0.9.34
- Documentación de opcións
+ ### Documentación de opcións ###
Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
https://tuxpaint.org/
@@ -46,11 +46,11 @@ vez que o inicie.
O ficheiro é simplemente un ficheiro de texto sinxelo que contén as opcións que
quere activar habilitar:
-Usuarios de Linux e Unix
+ ### Usuarios de Linux e Unix ###
/home/nome de usuario/.tuxpaintrc
-Ficheiro de configuración de todo o sistema
+## Ficheiro de configuración de todo o sistema ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -58,11 +58,11 @@ at:
/etc/tuxpaint/tuxpaint.conf
-Usuarios de macOS
+ ### Usuarios de macOS ###
/Users/nome de usuario/Library/Application Support/TuxPaint/tuxpaint.cfg
-Ficheiro de configuración de todo o sistema
+## Ficheiro de configuración de todo o sistema ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -70,7 +70,7 @@ at:
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Usuarios de Windows
+ ### Usuarios de Windows ###
C:\Users\nome de usuario\AppData\Roaming\TuxPaint\tuxpaint.cfg
@@ -78,7 +78,7 @@ Pode usar NotePad ou WordPad para crear este ficheiro. Asegúrese de gardalo
como texto simple e asegúrese de que o nome do ficheiro non teña «.txt» ao
final...
-Ficheiro de configuración de todo o sistema
+## Ficheiro de configuración de todo o sistema ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -86,7 +86,7 @@ at:
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -100,11 +100,11 @@ Os seguintes axustes pódense estabelecer no ficheiro de configuración. (A
configuración da liña de ordes substituirá estes. Vexa a sección «Opcións da
liña de ordes», a continuación.)
-Video/Sound
+ ### Video/Sound ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Executar o programa en modo de pantalla completa en vez de nunha xanela.
@@ -113,15 +113,15 @@ fullscreen=yes
overridden by the command-line option "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Executar o programa en modo de pantalla completa. Ademais, asume a
resolución actual da pantalla (estabelecida polo sistema operativo).
-
-windowsize=TAMAÑO
+
+→ windowsize=TAMAÑO ←
Executar o programa a un tamaño diferente (en modo xanela) ou a unha
resolución de pantalla diferente (en modo de pantalla completa), en lugar
@@ -143,8 +143,8 @@ windowsize=TAMAÑO
of the display, Tux Paint will fall back to the display's dimensions.
-
-orient=portrait
+
+→ orient=portrait ←
Cambia as opcións de largo/alto dadas a Tux Paint, útiles para xirar a
xanela nas pantallas verticais, como unha tableta que está en orientación
@@ -155,16 +155,16 @@ orient=portrait
be overridden by the command-line option "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
Ao executar Tux Paint en modo de pantalla completa, isto asume a resolución
actual da pantalla (anulando calquera opción «windowsize»), segundo o
estabelecido polo sistema operativo.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -177,11 +177,11 @@ allowscreensaver=yes
command-line option "--disablescreensaver".
+
+## Sound ##
-Sound
-
-nosound=yes
+→ nosound=yes ←
Desactivar os efectos de son. (Nota: Ao premer [Alt] + [S] non se poden
volver activar os sons se se desactivaron usando esta opción).
@@ -191,8 +191,8 @@ nosound=yes
cases, may be overridden by the command-line option "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Desactivar a compatibilidade con panorama estéreo. (Útil para usuarios con
discapacidade auditiva nun oído ou lugares onde se está a empregar un só
@@ -203,11 +203,11 @@ nostereo=yes
cases, may be overridden by the command-line option "--stereo".
+
+## Interface Size ##
-Interface Size
-
-buttonsize=TAMAÑO
+→ buttonsize=TAMAÑO ←
Estabeleza o tamaño dos píxeles dos botóns na interface de usuario de Tux
Paint (substituíndo o predeterminado de «48»). Útil cando se usan pantallas
@@ -229,8 +229,8 @@ buttonsize=TAMAÑO
stderr.)
-
-colorsrows=FILAS
+
+→ colorsrows=FILAS ←
Cantas filas de botóns da paleta de cores amosar; útil cando se usa unha
gran paleta de cores (ver «colorfile», arriba) e/ou para usar con
@@ -238,13 +238,13 @@ colorsrows=FILAS
pode estar entre «1» (o predeterminado) e «3».
+
+ ### Mouse/Keyboard ###
-Mouse/Keyboard
+## Cursor ##
-Cursor
-
-nofancycursors=yes
+→ nofancycursors=yes ←
Isto desactiva as fantásticas formas do punteiro do rato en Tux Paint e usa
o punteiro normal do seu contorno.
@@ -258,8 +258,8 @@ nofancycursors=yes
"--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
Isto agocha completamente as formas do punteiro do rato en Tux Paint.
@@ -270,11 +270,11 @@ hidecursor=yes
both cases, may be overridden by the command-line option "--showcursor".
+
+## Keyboard ##
-Keyboard
-
-noshortcuts=yes
+→ noshortcuts=yes ←
Isto desactiva os atallos de teclado (por exemplo,[Ctrl]-[S] para gardar,
[Ctrl]-[N] para unha nova imaxe, etc.)
@@ -287,11 +287,11 @@ noshortcuts=yes
both cases, may be overridden by the command-line option "--shortcuts".
+
+## Mouse ##
-Mouse
-
-grab=yes
+→ grab=yes ←
Tux Paint tentará «amarrar» o rato e o teclado, de xeito que o rato estea
confinado na xanela de Tux Paint e case toda a entrada do teclado se lle
@@ -306,8 +306,8 @@ grab=yes
cases, may be overridden by the command-line option "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
Isto desactiva a compatibilidade para a roda dos ratos que a teñen.
(Normalmente, a roda desprazará o menú do selector á dereita.)
@@ -317,8 +317,8 @@ nowheelmouse=yes
In both cases, may be overridden by the command-line option "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Antes do Tux Paint 0.9.15, tamén se podían empregar os botóns medio e
dereito do rato para premer. Na versión 0.9.15, cambiouse para que só
@@ -335,13 +335,13 @@ nobuttondistinction=yes
command-line option "--buttondistinction".
+
+ ### Simplificación ###
-Simplificación
+## Interface Simplification ##
-Interface Simplification
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Desactive o paso de rotación da ferramenta «Forma». Prema, arrastra e solte
é todo o que se necesita para debuxar unha forma.
@@ -352,8 +352,8 @@ simpleshapes=yes
"--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
Neste modo, amósanse contornos e liñas «elásticas» moito máis sinxelas
cando se usan as ferramentas Liñas, Formas, Selos e Goma.
@@ -366,8 +366,8 @@ nooutlines=yes
both cases, may be overridden by the command-line option "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
Todo o texto renderizarase só con maiúscula (por exemplo, «Pincel» será
«PINCEL»). Útil para os cativos que saben ler, pero que ata agora só
@@ -378,11 +378,11 @@ uppercase=yes
both cases, may be overridden by the command-line option "--mixedcase".
+
+## Tamaño inicial do selo ##
-Tamaño inicial do selo
-
-stampsize=TAMAÑO
+→ stampsize=TAMAÑO ←
Use esta opción para forzar a Tux Paint a estabelecer o tamaño inicial de
todos os selos. O valor TAMAÑO debería estar entre 0 (máis pequeno) e 10
@@ -393,11 +393,11 @@ stampsize=TAMAÑO
estándar).
+
+## Control Simplification ##
-Control Simplification
-
-noquit=yes
+→ noquit=yes ←
Desactivar o botón «Saír» na pantalla e evitar saír de Tux Paint coa tecla
[Escape].
@@ -414,8 +414,8 @@ noquit=yes
cases, may be overridden by the command-line option "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
Esta opción dille a Tux Paint que non cargue ningunha imaxe de selo de
caucho, o que á súa vez acaba desactivando a ferramenta Selos.
@@ -429,8 +429,8 @@ nostamps=yes
cases, may be overridden by the command-line option "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Algunhas imaxes da ferramenta Selos pódense reflectir, inverter e/ou
cambiar o seu tamaño. Esta opción desactiva os controis e só fornece os
@@ -442,8 +442,8 @@ nostampcontrols=yes
"--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
This disables the rotation step of the Stamps tool, immediately placing the
stamp in its regular orientation (with any flipping or mirroring applied)
@@ -458,8 +458,8 @@ nostamprotation=yes
"--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Algunhas ferramentas de Maxia teñen a opción de actuar coma un pincel ou
afectar todo o lenzo á vez. Esta opción desactiva os controis e só fornece
@@ -471,8 +471,8 @@ nomagiccontrols=yes
"--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Some Magic tools offer various size settings. This option disables the
sizing control, and only provides the tools' default sizes. (Some plugins
@@ -484,8 +484,8 @@ nomagicsizes=yes
In both cases, may be overridden by the command-line option "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -501,8 +501,8 @@ ungroupmagictools=yes
option "--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Desactivar os botóns de control que se amosan cando se usa a ferramenta
Formas que permiten cambiar como se debuxan as formas: centradas arredor do
@@ -514,8 +514,8 @@ noshapecontrols=yes
"--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Desactiva a ferramenta Etiqueta: a ferramenta que permite a entrada de
texto que se pode editar máis tarde.
@@ -525,8 +525,8 @@ nolabel=yes
cases, may be overridden by the command-line option "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Disables the brush spacing option of the Paint and Lines tools. The
brushes' default spacings will be used.
@@ -540,8 +540,8 @@ nobrushspacing=yes
"--brushspacing".
-
-complexity=COMPLEXITY
+
+→ complexity=COMPLEXITY ←
Sets the complexity (expertise) level of Tux Paint, which can either
disable some Magic tools, or cause them to operate differently. (For
@@ -551,18 +551,18 @@ complexity=COMPLEXITY
The COMPLEXITY value may be one of:
- advanced (o predeterminado)
+ → advanced (o predeterminado) ←
"Advanced" — For users familiar with Tux Paint and who can operate more
complex tools.
-
- beginner
+
+ → beginner ←
"Beginner" — For users comfortable with Tux Paint, but where complex
tools may cause confusion or frustration.
-
- novice
+
+ → novice ←
"Novice" — For first-time Tux Paint users, users inexperienced with
computers, or those with special accessibility needs.
-
+
📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
Consult the individual Magic tools' documentation.
@@ -572,8 +572,8 @@ complexity=COMPLEXITY
may be overridden by the command-line option "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Disables the ability to create a new Template image (based on a saved
drawing) from within the Open dialog.
@@ -587,8 +587,8 @@ notemplateexport=yes
option "--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Disables the ability to erase saved drawings via the "Erase" button on the
Open dialog, or exported Template images (based on a saved drawing) via the
@@ -602,13 +602,13 @@ noerase=yes
cases, may be overridden by the command-line option "--erase".
+
+ ### Languages ###
-Languages
+## Language ##
-Language
-
-lang=IDIOMA
+→ lang=IDIOMA ←
Run Tux Paint in one of the supported languages. Possible choices for
LANGUAGE currently include:
@@ -870,8 +870,8 @@ lang=IDIOMA
+-----------------------------------------------------------------+
-
---locale IDIOMA
+
+→ --locale IDIOMA ←
Execute Tux Paint nun dos idiomas compatíbeis. Vexa a sección «Escoller un
idioma diferente» a continuación para ver as cadeas de configuración local
@@ -882,8 +882,8 @@ lang=IDIOMA
respecta a configuración do seu contorno, se é posíbel).
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
Para os selos que se poden reflectir, esta opción estabeléceos de xeito
predeterminado na súa forma reflectida.
@@ -897,11 +897,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Tipos de letra ##
-Tipos de letra
-
-sysfonts=yes
+→ sysfonts=yes ←
Esta opción fai que Tux Paint tente cargar tipos de letra (para usalos na
ferramenta Texto) dende o seu sistema operativo. Normalmente, Tux Paint só
@@ -912,8 +912,8 @@ sysfonts=yes
both cases, may be overridden by the command-line option "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Antes da versión 0.9.21, Tux Paint cargaba todos os tipos de letra no seu
propio directorio de tipos de letra, incluídos os específicos da
@@ -931,8 +931,8 @@ alllocalefonts=yes
command-line option "--currentlocalefont".
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
Esta opción fai que Tux Paint tente cargar tipos de letra (para usalos na
ferramenta Texto) dende o seu sistema operativo. Normalmente, Tux Paint só
@@ -942,19 +942,19 @@ uifont=FONT NAME
standard behavior).
+
+ ### Impresión ###
-Impresión
+## Print Permissions ##
-Print Permissions
-
-noprint=yes
+→ noprint=yes ←
Desactivar a función de impresión.
-
-printdelay=SEGUNDOS
+
+→ printdelay=SEGUNDOS ←
Restrinxir a impresión para que só poida producirse unha vez cada SEGUNDOS
segundos.
@@ -964,11 +964,11 @@ printdelay=SEGUNDOS
overridden by the command-line option "--printdelay=0".
+
+## Show Printer Dialog ##
-Show Printer Dialog
-
-altprint=always
+→ altprint=always ←
Isto fai que Tux Paint amose sempre o diálogo da impresora (ou, en Linux/
Unix, execute a orde «altprint») cando se preme no botón «Imprimir».
@@ -976,8 +976,8 @@ altprint=always
agás que non precisa manter premida [Alt] cada vez.
-
-altprint=never
+
+→ altprint=never ←
Isto evita que Tux Paint nunca amose o diálogo da impresora (ou, en Linux/
Unix, execute «altprintcommand») cando se preme no botón «Imprimir».
@@ -985,8 +985,8 @@ altprint=never
«Imprimir».
-
-altprint=mod
+
+→ altprint=mod ←
Este é o comportamento normal e predeterminado. Tux Paint amosa un diálogo
de impresora (ou, en Linux/Unix, executa a orde «altprint»), cando se preme
@@ -994,11 +994,11 @@ altprint=mod
sen manter premida [Alt] imprime sen amosar un diálogo.
+
+## Save Printer Configuration ##
-Save Printer Configuration
-
- printcfg=yes
+ → printcfg=yes ←
(Só Windows e macOS)
@@ -1019,11 +1019,11 @@ Save Printer Configuration
"--noprintcfg".
+
+ ## Print Commands ##
- Print Commands
-
- printcommand=ORDE
+ → printcommand=ORDE ←
(Só Linux e Unix)
@@ -1041,8 +1041,8 @@ Save Printer Configuration
configuración antes da versión 0.9.15, terá que cambiala.
-
- altprintcommand=ORDE
+
+ → altprintcommand=ORDE ←
(Só Linux e Unix)
@@ -1058,11 +1058,11 @@ Save Printer Configuration
kprinter
+
+ ## Paper Size ##
- Paper Size
-
- papersize=TAMAÑO_DO_PAPEL
+ → papersize=TAMAÑO_DO_PAPEL ←
(Plataformas que usan o xerador interno PostScript de Tux Paint; non
Windows, macOS, BeOS ou Haiku).
@@ -1079,40 +1079,40 @@ Save Printer Configuration
dsheet, esheet.
+
+ ### Gardar ###
- Gardar
+ ## Save Over Earlier Work ##
- Save Over Earlier Work
-
- saveover=yes
+ → saveover=yes ←
Isto desactiva a pregunta «Gardar sobre a versión antiga...?» ao gardar
un ficheiro existente. Con esta opción, a versión anterior sempre será
substituída pola nova versión automaticamente.
-
- saveover=new
+
+ → saveover=new ←
Isto tamén desactiva a pregunta «Gardar sobre a versión antiga...?»
cando garda un ficheiro existente. Non obstante, esta opción sempre
gardará un novo ficheiro no canto de sobrescribir a versión anterior.
-
- saveover=ask
+
+ → saveover=ask ←
(Esta opción é redundante, xa que esta é a opción predeterminada.) Ao
gardar un debuxo existente, primeiro preguntaráselle se quere gardar
sobre a versión anterior ou non.
+
+ ## Starting Out ##
- Starting Out
-
- startblank=yes
+ → startblank=yes ←
Isto fai que Tux Paint amose un lenzo en branco cando se inicia por vez
primeira, no canto de cargar a última imaxe que se estaba a editar.
@@ -1123,8 +1123,8 @@ Save Printer Configuration
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Coloca as opcións de cor en branco no diálogo Novo ao final, de xeito
que se amosen primeiro os iniciadores e/ou modelos.
@@ -1135,30 +1135,30 @@ Save Printer Configuration
command-line option "--newcolorsfirst".
+
+ ## Save and Export Directories ##
- Save and Export Directories
-
- savedir=DIRECTORIO
+ → savedir=DIRECTORIO ←
Use esta opción para cambiar onde se atopa o directorio/cartafol
«saved» de Tux Paint, que é onde Tux Paint garda e abre imaxes.
Se non o anula, a ubicación predeterminada é:
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/nome de usuario/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\nome de usuario\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/nome de usuario/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.
@@ -1171,8 +1171,8 @@ Save Printer Configuration
Exemplo: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORIO
+
+ → exportdir=DIRECTORIO ←
Use esta opción para cambiar onde Tux Paint exporta ficheiros —imaxes
individuais ou diaporamasositivas GIF animadas— uso externo.
@@ -1212,11 +1212,11 @@ Save Printer Configuration
Exemplo: exportdir=/home/penguin/TuxPaintExports
+
+ ## More Saving Options ##
- More Saving Options
-
- nosave=yes
+ → nosave=yes ←
Isto desactiva a capacidade de Tux Paint para gardar ficheiros (e, polo
tanto, desactiva o botón «Gardar» na pantalla). Pode usarse en
@@ -1228,8 +1228,8 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--save".
-
- autosave=yes
+
+ → autosave=yes ←
Isto impide a Tux Paint preguntar se quere gardar a imaxe actual ao
saír e supón que si.
@@ -1240,8 +1240,8 @@ Save Printer Configuration
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
This reverses the sorting of the Open and Slideshow dialogs, placing
the newest images at the top of the list.
@@ -1252,13 +1252,13 @@ Save Printer Configuration
command-line option "--noreversesort".
+
+ ### Data ###
- Data
+ ## Lockfile ##
- Lockfile
-
- nolockfile=yes
+ → nolockfile=yes ←
De xeito predeterminado, Tux Paint usa o que se coñece como «ficheiro
de bloqueo» para evitar que se inicie máis dunha vez en 30 segundos.
@@ -1280,11 +1280,11 @@ Save Printer Configuration
"--lockfile".
+
+ ## Data Directory ##
- Data Directory
-
- datadir=DIRECTORIO
+ → datadir=DIRECTORIO ←
Use esta opción para cambiar onde Tux Paint busca ficheiros de datos
persoais (pinceis, selos, imaxes de comezo, modelos e tipos de letra
@@ -1296,15 +1296,15 @@ Save Printer Configuration
Se non o anula, a ubicación predeterminada é:
- Linux / Unix
+ → Linux / Unix ←
/home/nome de usuario/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\nome de usuario\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/nome de usuario/Library/Application Support/TuxPaint/
-
+
📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting
or default as for "savedir" to search for data files. As of version
@@ -1316,11 +1316,11 @@ Save Printer Configuration
Exemplo: datadir=/home/johnny/tuxpaint-data/
+
+ ## Color Palette File ##
- Color Palette File
-
- colorfile=NOME_DE_FICHEIRO
+ → colorfile=NOME_DE_FICHEIRO ←
Pode anular a paleta de cores predeterminada de Tux Paint creando un
ficheiro de texto ASCII simple que describa as cores que quere e
@@ -1349,23 +1349,23 @@ Save Printer Configuration
non que «#F0F0F0».
+
+ ### Accessibility ###
- Accessibility
+ ## Mouse ##
- Mouse
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
Neste modo, no canto de premer, arrastrar e soltar (por exemplo, para
debuxar), premese, móvese e premese de novo para rematar o movemento.
+
+ ## Keyboard ##
- Keyboard
-
- keyboard=yes
+ → keyboard=yes ←
Isto permite empregar as teclas de frecha do teclado para controlar o
punteiro do rato. (por exemplo, para contornos sen rato ou persoas con
@@ -1408,18 +1408,18 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--mouse".
+
+ ## Onscreen Keyboard ##
- Onscreen Keyboard
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Presenta un teclado en pantalla sobre que se pode premer cando empregan
as ferramentas Texto e Etiqueta.
-
- onscreen-keyboard-layout=NOME DA DISPOSICIÓN
+
+ → onscreen-keyboard-layout=NOME DA DISPOSICIÓN ←
Selects the initial layout for the on-screen keyboard when using the
Text and Label tools.
@@ -1427,8 +1427,8 @@ Save Printer Configuration
polo que estabelecer ambas as cousas é redundante.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Desactiva a posibilidade de cambiar o deseño do teclado en pantalla
cando se usan as ferramentas Texto e Etiqueta, útil para simplificar as
@@ -1442,65 +1442,65 @@ Save Printer Configuration
by the command-line option "--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Main Device ##
- Main Device
-
- joystick-dev=N
+ → joystick-dev=N ←
Especifica que dispositivo de mando debe ser usado por Tux Paint. O
valor predeterminado é 0 (a primeira panca de mando — joystick).
-
- joystick-slowness=VELOCIDADE
+
+ → joystick-slowness=VELOCIDADE ←
Estabelece un atraso en cada movemento do eixo, permitindo atrasar a
panca de mando (joystick). Os valores permitidos van de 0 a 500. O
valor predeterminado é 15.
-
- joystick-threshold=LIMIAR
+
+ → joystick-threshold=LIMIAR ←
Estabelece o nivel mínimo de movemento do eixe para comezar a mover o
punteiro. Os valores permitidos son de 0 a 32766. O valor
predeterminado é 3200.
-
- joystick-maxsteps=PASOS
+
+ → joystick-maxsteps=PASOS ←
Define os píxeles máximos que moverá o punteiro á vez. Os valores
permitidos van do 1 ao 7. O valor predeterminado é 7.
+
+ ## Hat ##
- Hat
-
- joystick-hat-slowness=VELOCIDADE
+ → joystick-hat-slowness=VELOCIDADE ←
Estabelece un atraso en cada movemento automático, o que permite
diminuír a velocidade do sombreiro. Os valores permitidos van de 0 a
500. O valor predeterminado é 15.
-
- joystick-hat-timeout=MILISEGUNDOS
+
+ → joystick-hat-timeout=MILISEGUNDOS ←
Estabelece o atraso após de que o punteiro comezará a moverse
automaticamente se se mantén premido o sombreiro. Os valores permitidos
van de 0 a 3000. O valor predeterminado é 1000.
+
+ ## Buttons to Disable ##
- Buttons to Disable
-
- joystick-buttons-ignore=BOTÓN1,BOTÓN2,...
+ → joystick-buttons-ignore=BOTÓN1,BOTÓN2,... ←
Un conxunto de números de botóns do mando (joystick), como se ve en
SDL, que deben ignorarse. Se non, a menos que sexan utilizados por unha
@@ -1508,133 +1508,133 @@ Save Printer Configuration
esquerdo do rato.
+
+## Button Shortcuts ##
-Button Shortcuts
-
- joystick-btn-escape=NÚMERO DE BOTÓN
+ → joystick-btn-escape=NÚMERO DE BOTÓN ←
Selecciona o número do botón da panca de control (joystick), tal e como
o ve SDL, que se usará para xerar un evento de escape. Útil para
desactivar os diálogos e saír.
-
- joystick-btn-brush=NÚMERO DE BOTÓN
+
+ → joystick-btn-brush=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de pinceis.
-
- joystick-btn-stamp=NÚMERO DE BOTÓN
+
+ → joystick-btn-stamp=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de selos.
-
- joystick-btn-lines=NÚMERO DE BOTÓN
+
+ → joystick-btn-lines=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de liñas.
-
- joystick-btn-shapes=NÚMERO DE BOTÓN
+
+ → joystick-btn-shapes=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de formas.
-
- joystick-btn-text=NÚMERO DE BOTÓN
+
+ → joystick-btn-text=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de texto.
-
- joystick-btn-label=NÚMERO DE BOTÓN
+
+ → joystick-btn-label=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de etiquetas.
-
- joystick-btn-fill=NÚMERO DE BOTÓN
+
+ → joystick-btn-fill=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a select the fill tool.
-
- joystick-btn-magic=NÚMERO DE BOTÓN
+
+ → joystick-btn-magic=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a seleccionar a ferramenta de máxia.
-
- joystick-btn-undo=NÚMERO DE BOTÓN
+
+ → joystick-btn-undo=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a invocar a ferramenta de desfacer.
-
- joystick-btn-redo=NÚMERO DE BOTÓN
+
+ → joystick-btn-redo=NÚMERO DE BOTÓN ←
Selecciona o número do botón da panca de mando (joystick), tal e como o
ve SDL, que será un atallo para seleccionar ferramenta de refacer.
-
- joystick-btn-eraser=NÚMERO DE BOTÓN
+
+ → joystick-btn-eraser=NÚMERO DE BOTÓN ←
Selecciona o número do botón da panca de mando (joystick), tal e como o
ve SDL, que será un atallo para seleccionar ferramenta de goma de
borrar.
-
- joystick-btn-new=NÚMERO DE BOTÓN
+
+ → joystick-btn-new=NÚMERO DE BOTÓN ←
Selecciona o número do botón da panca de mando (joystick), como o ve
SDL, que será un atallo para iniciar o diálogo para crear un novo
debuxo.
-
- joystick-btn-open=NÚMERO DE BOTÓN
+
+ → joystick-btn-open=NÚMERO DE BOTÓN ←
Selecciona o número do botón da panca de mando (joystick), como o ve
SDL, que será un atallo para iniciar o diálogo para abrir un debuxo
existente.
-
- joystick-btn-save=NÚMERO DE BOTÓN
+
+ → joystick-btn-save=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a garda o debuxo.
-
- joystick-btn-pgsetup=NÚMERO DE BOTÓN
+
+ → joystick-btn-pgsetup=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a inicia o diálogo de configuración da páxina para imprimir.
-
- joystick-btn-print=NÚMERO DE BOTÓN
+
+ → joystick-btn-print=NÚMERO DE BOTÓN ←
Selecciona o número do botón do joystick, como o ve SDL, que será un
atallo a imprimir.
-
+
Anulación da configuración do sistema. Opcións
@@ -1660,7 +1660,7 @@ Button Shortcuts
Options may also be issued on the command-line when you go to launch Tux
Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--LARGOxALTO
--orient=portrait
@@ -1742,13 +1742,14 @@ Button Shortcuts
--reversesort
--lang IDIOMA
--colorfile FICHEIRO
+ ←
Estas activan ou corresponden ás opcións do ficheiro de configuración
descritas anteriormente.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1789,6 +1790,7 @@ Button Shortcuts
--save
--noautosave
--noreversesort
+ ←
Estas opcións pódense usar para anular calquera axuste feito no
ficheiro de configuración. (Se a opción non está configurada no(s)
@@ -1796,8 +1798,8 @@ Button Shortcuts
anulación.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1807,53 +1809,53 @@ Button Shortcuts
used.
+
-
- Opcións informativas da liña de ordes
+ ### Opcións informativas da liña de ordes ###
As seguintes opcións amosan un texto informativo na pantalla. Non obstante,
Tux Paint non se inicia nin se executa despois.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Amosa información breve sobre a licenza para copiar Tux Paint.
-
- --usage
+
+ → --usage ←
Amosa a lista de opcións de liña de ordes dispoñíbeis.
-
- --help
+
+ → --help ←
Amosa unha breve axuda sobre o uso de Tux Paint.
-
- --lang help
+
+ → --lang help ←
Amosa unha lista de idiomas dispoñíbeis en Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Amosa a lista de pancas de mando (joysticks) conectados dispoñíbeis
para Tux Paint.
-
+
Escoller un idioma diferente
@@ -1867,7 +1869,7 @@ Button Shortcuts
Use the option "--lang help" to list the language options available.
- Idiomas dispoñíbeis
+ ### Idiomas dispoñíbeis ###
+-------------------------------------------------------------------------+
| | | Idioma | Combinación de |
@@ -2169,7 +2171,7 @@ Button Shortcuts
can be used to cycle through the supported input methods while the Text
tool is active.
- Axustar o idioma do seu contorno
+ ### Axustar o idioma do seu contorno ###
Cambiar a súa configuración local afectará a gran parte do seu contorno.
@@ -2181,7 +2183,7 @@ Button Shortcuts
Se aínda non estabeleceu a configuración local do seu contorno, o seguinte
explicará brevemente como:
- Usuarios de Linux/Unix
+ ## Usuarios de Linux/Unix ##
Primeiro, asegúrese de que a configuración local que quere usar está
activada editando o ficheiro «/etc/locale.gen» no seu sistema e logo
@@ -2210,7 +2212,7 @@ Button Shortcuts
setenv LANG es_ES ; \
tuxpaint
- Usuarios de Windows
+ ## Usuarios de Windows ##
Tux Paint recoñecerá a configuración local actual e empregará de xeito
predeterminado os ficheiros apropiados. Polo tanto, esta sección é só para
@@ -2235,7 +2237,7 @@ Button Shortcuts
+ Prema no botón «Variábeis de contorno...».
+ Edite o valor do parámetr «LANG») (créeo, se non existe).
- Tipos de letra especiais
+ ### Tipos de letra especiais ###
Algúns idiomas requiren que se instalen tipos de letra especiais. Estes
ficheiros de letra (que están en formato TrueType (TTF)), son demasiado
diff --git a/docs/gl_ES.UTF-8/PNG.txt b/docs/gl_ES.UTF-8/PNG.txt
index d9ca16ee2..ee7192bd3 100644
--- a/docs/gl_ES.UTF-8/PNG.txt
+++ b/docs/gl_ES.UTF-8/PNG.txt
@@ -27,12 +27,12 @@ A compatibilidade con moitas cores permite utilizar imaxes de «selo de caucho»
de calidade fotográfica en Tux Paint e a transparencia alfa permite pinceis de
alta calidade.
-Como facer imaxes PNG
+ ### Como facer imaxes PNG ###
A continuación amosarase unha lista moi breve de xeitos de crear PNG ou
converter as imaxes existentes a PNG.
-GIMP & Krita
+→ GIMP & Krita ←
GIMP e Krita son dúas excelentes ferramentas coas que crear imaxes PNG para
usar en Tux Paint , ambos son programas de debuxo interactivo e edición de
@@ -44,10 +44,10 @@ GIMP & Krita
www.gimp.org/ e http://www.krita.org/ respectivamente.
+
+→ Ferramentas da liña de ordes ←
-Ferramentas da liña de ordes
-
- NetPBM
+ → NetPBM ←
As ferramentas de Mapas de bits Portátil –Portable Bitmap– (coñecidas
colectivamente como «NetPBM») son unha colección de ferramentas de liña
@@ -59,8 +59,8 @@ Ferramentas da liña de ordes
non é así, ou para saber máis, visite http://netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
Os programas de liña de ordes «cjpeg» e «djpeg» converten entre o
formato NetPBM Calquera mapa portátil –Portable Any Map– (PNM) e os
@@ -69,11 +69,11 @@ Ferramentas da liña de ordes
non é así, ou para saber máis, visite https://jpegclub.org/.
+
-
-
-Proprietary Software for Windows
+
+→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -81,13 +81,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Usuarios de Macintosh
+
+→ Usuarios de Macintosh ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/gl_ES.UTF-8/README.txt b/docs/gl_ES.UTF-8/README.txt
index c9c7a47cb..c6e7140ca 100644
--- a/docs/gl_ES.UTF-8/README.txt
+++ b/docs/gl_ES.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
versión 0.9.34
- Un sinxelo programa de debuxo para cativos
+ ## Un sinxelo programa de debuxo para cativos ##
Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
https://tuxpaint.org/
- 12 de Outubro de 2024
+ 14 de Outubro de 2024
+--------------------------------------------------------+
| Índice |
@@ -44,7 +44,7 @@
I. Sobre Tux Paint
-A. Que é «Tux Paint»?
+ ### A. Que é «Tux Paint»? ###
Tux Paint é un programa de debuxo libre e de balde deseñado para cativos (3 ou
máis anos). Ten unha interface sinxela e doada de usar, divertidos efectos de
@@ -52,44 +52,44 @@ son e unha mascota de debuxos animados que axuda a guiar aos cativos mentres
usan o programa. Ofrece un lenzo en branco e unha ampla variedade de
ferramentas de debuxo para axudar ao seu cativo a ser creativo.
-B. Objectives
+ ### B. Objectives ###
-Doado e divertido
+→ Doado e divertido ←
Tux Paint pretende ser un sinxelo programa de debuxo para cativos pequenos.
Non está pensado como unha ferramenta de debuxo de uso xeral. Preténdese
que sexa divertido e doado de usar. Os efectos de son e un personaxe de
debuxos animados permiten que o usuario saiba o que está pasando e o mantén
entretido. Tamén hai formas de punteiro de rato estilo debuxo animado de
gran tamaño.
-
-Ampliabilidade
+
+→ Ampliabilidade ←
Tux Paint é ampliábel. Os pinceis e as formas do «selo de caucho»
arrastrarse e soltarse. Por exemplo, un profesor pode soltar unha colección
de formas de animais e pedirlles aos seus alumnos que debuxen un
ecosistema. Cada forma pode ter un son que se reproduce e datos textuais
que se amosan cando o cativo selecciona a forma.
-
-Portabilidade
+
+→ Portabilidade ←
Tux Paint é portátil entre varias plataformas informáticas: Windows,
Macintosh, Linux, etc. A interface ten o mesmo aspecto en todas. Tux Paint
funciona adecuadamente en sistemas antigos e pódese construír para
funcionar mellor en sistemas lentos.
-
-Simplicidade
+
+→ Simplicidade ←
Non hai acceso directo ás complexidades subxacentes do computador. A imaxe
actual consérvase cando se pecha o programa e volve aparecer cando se
reinicia. Para gardar imaxes non é necesario crear nomes de ficheiro nin
usar o teclado. A apertura dunha imaxe faise seleccionándoa nunha colección
de miniaturas. O acceso a outros ficheiros da computadora está restrinxido.
-
-Accessibility
+
+→ Accessibility ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
+
-
-C. Licenza
+ ### C. Licenza ###
Tux Paint é un proxecto de código aberto, software libre publicado baixo a
licenza pública xeral GNU (GPL). É de balde e o «código fonte» detrás do
@@ -98,62 +98,76 @@ corrixir erros e usar partes do programa no seu propio software GPL).
Consulte o texto completo da licenza GPL en COPYING.txt.
-D. What's New in Tux Paint version 0.9.34?
+ ### D. What's New in Tux Paint version 0.9.34? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
See CHANGES.txt for the complete list of changes.
II. Uso de Tux Paint
-A. Inicio de Tux Paint
+ ### A. Inicio de Tux Paint ###
-1. Usuarios de Linux/Unix
+## 1. Usuarios de Linux/Unix ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@@ -165,7 +179,7 @@ dicir, «$»):
Se se producen erros, amosaranse no terminal (en STDERR).
-2. Usuarios de Windows
+## 2. Usuarios de Windows ##
[Icona de Tux Paint]
Tux Paint
@@ -188,13 +202,14 @@ installer.
Se usou a descarga de «ficheiro ZIP», o cartafol de Tux Paint estará onde teña
extraído o contido do ficheiro ZIP.
-3. Usuarios de macOS
+## 3. Usuarios de macOS ##
Simplemente fai dobre clic na icona «Tux Paint».
[Pantalla de título]
+
-B. Pantalla de título
+ ### B. Pantalla de título ###
Cando se cargue por primeira vez Tux Paint, aparecerá unha pantalla de título/
recoñecementos.
@@ -203,20 +218,22 @@ Unha vez completada a carga, prema unha tecla, faga clic ou toque na xanela de
Tux Paint para continuar. (Ou, após aproximadamente 5 segundos, a pantalla do
título desaparecerá automaticamente.)
-C. Pantalla principal
+ ### C. Pantalla principal ###
A pantalla principal divídese nas seguintes seccións:
[Ferramentas: Pintar, Selo, Liñas, Formas, Texto, Maxia, Etiqueta, Desfacer,
Refacer, Borrador, Novo, Abrir, Gardar, Imprimir, Saír]
-Lado esquerdo: Barra de Ferramentas
+
+→ Lado esquerdo: Barra de Ferramentas ←
A barra de ferramentas contén os controis de debuxo e edición.
-
+
[Lenzo]
-Medio: Lenzo de debuxo
+
+→ Medio: Lenzo de debuxo ←
A parte máis grande da pantalla, no centro, é o lenzo de debuxo. Aquí é,
obviamente, onde debuxa.
@@ -227,9 +244,10 @@ Medio: Lenzo de debuxo
para obter máis detalles.
-
+
[Selectores: pinceis, letras, formas, selos]
-Lado dereito: Selector
+
+→ Lado dereito: Selector ←
Dependendo da ferramenta actual, o selector amosa cousas diferentes. p.
ex.: cando se selecciona a ferramenta Pincel ou Liña, amosa os distintos
@@ -238,10 +256,11 @@ Lado dereito: Selector
ou Etiqueta, amosa varios tipos de letra.
-
+
[Cores: negro, branco, vermello, rosa, laranxa, amarelo, verde, cian, azul,
roxo, marrón, gris]
-Máis abaixo: Cores
+
+→ Máis abaixo: Cores ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@@ -297,23 +316,24 @@ Máis abaixo: Cores
documentation.
-
+
(Consello de exemplo: «Escolle unha figura. Preme para marcar o centro,
arrastra e solta cando teña o tamaño que queiras. Move arredor para
invertela, e preme para debuxala.»)
-Abaixo de todo: Área de axuda
+
+→ Abaixo de todo: Área de axuda ←
Na parte inferior da pantalla, Tux, o pingüín de Linux, ofrece consellos e
outra información mentres usa Tux Paint.
+
+ ### D. Ferramentas dispoñíbeis ###
-D. Ferramentas dispoñíbeis
+## 1. Ferramentas de debuxo ##
-1. Ferramentas de debuxo
-
-a. Ferramenta «Pintar» (pinceis)
+a. Ferramenta «Pintar» (pinceis) ←
A ferramenta Pincel permítelle debuxar a man alzada usando varios pinceis
(escollidos no Selector da dereita) e cores (escollidos na Paleta de cores
@@ -355,8 +375,8 @@ a. Ferramenta «Pintar» (pinceis)
the brush spacing controls. See the "Options" documentation.
-
-b.Ferramenta «Selo» (selos de caucho)
+
+b.Ferramenta «Selo» (selos de caucho) ←
A ferramenta Selo é como un conxunto de selos de cacho ou adhesivos.
Permítelle pegar imaxes fotográficas ou debuxadas previamente (como a imaxe
@@ -366,13 +386,13 @@ b.Ferramenta «Selo» (selos de caucho)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
- Stamp Categories
+ → Stamp Categories ←
Pode haber numerosas categorías de selos (por exemplo, animais,
plantas, espazo exterior, vehículos, persoas, etc.). Use as frechas
esquerda e dereita preto da parte inferior do selector para percorrer
as coleccións.
-
- Stamp Rotation
+
+ → Stamp Rotation ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@@ -389,8 +409,8 @@ b.Ferramenta «Selo» (selos de caucho)
0.9.29.
-
- Stamp Controls
+
+ → Stamp Controls ←
Antes de «estampar» unha imaxe no seu debuxo, ás veces pódense aplicar
varios efectos (dependendo do selo):
@@ -410,8 +430,8 @@ b.Ferramenta «Selo» (selos de caucho)
Options" documentation.
-
- Stamp Sounds
+
+ → Stamp Sounds ←
Diferentes selos poden ter diferentes efectos sonoros e/ou sons
descritivos (falados). Os botóns da área de axuda na parte inferior
@@ -420,11 +440,11 @@ b.Ferramenta «Selo» (selos de caucho)
momento.
+
-
-
-c.Ferramenta «Liñas»
+
+c.Ferramenta «Liñas» ←
Esta ferramenta permítelle debuxar liñas rectas empregando os diversos
pinceis e cores que normalmente emprega co pincel.
@@ -449,8 +469,8 @@ c.Ferramenta «Liñas»
to learn more.
-
-d.Ferramenta «Formas»
+
+d.Ferramenta «Formas» ←
Esta ferramenta permítelle debuxar algunhas formas sinxelas enchidas e sen
encher.
@@ -461,15 +481,15 @@ d.Ferramenta «Formas»
Use as opcións da parte inferior dereita para escoller o comportamento da
ferramenta de forma:
- Formas dende o centro
+ → Formas dende o centro ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
-
- Formas dende cantos
+
+ → Formas dende cantos ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@@ -477,7 +497,7 @@ d.Ferramenta «Formas»
📜 This option was added starting with Tux Paint version 0.9.25.
-
+
⚙ Nota: Se os controis de forma están desactivados (p. ex.: coa opción
«noshapecontrols»), non se presentarán os controis e empregarase o método
@@ -495,7 +515,7 @@ d.Ferramenta «Formas»
Solte o rato cando remate de estirar.
- Modo de formas normais
+ → Modo de formas normais ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@@ -504,8 +524,8 @@ d.Ferramenta «Formas»
Prema de novo no botón do rato e a forma debuxarase na cor actual.
-
- Modo de formas simples
+
+ → Modo de formas simples ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@@ -514,11 +534,11 @@ d.Ferramenta «Formas»
("simpleshapes") option.
+
-
-
-e.Ferramentas «Texto» e «Etiquetas»
+
+e.Ferramentas «Texto» e «Etiquetas» ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@@ -539,7 +559,7 @@ e.Ferramentas «Texto» e «Etiquetas»
activa, a liña de texto actual moverase a esa posición (onde pode continuar
editándoa).
- Comparación de «Texto» con «Etiqueta»
+ → Comparación de «Texto» con «Etiqueta» ←
A ferramenta Texto é a ferramenta de entrada de texto orixinal en Tux
Paint. O texto introducido usando esta ferramenta non se pode modificar
@@ -574,8 +594,8 @@ e.Ferramentas «Texto» e «Etiquetas»
Tux Paint coa opción «nolabel»).
-
- Introdución de caracteres internacionais
+
+ → Introdución de caracteres internacionais ←
Tux Paint permite introducir caracteres en diferentes idiomas. A
maioría dos caracteres latinos (A-Z, ñ, è, etc.) poden introducirse
@@ -604,8 +624,8 @@ e.Ferramentas «Texto» e «Etiquetas»
trying to type.
-
- Teclado en pantalla
+
+ → Teclado en pantalla ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@@ -615,11 +635,11 @@ e.Ferramentas «Texto» e «Etiquetas»
information.
+
-
-
-f.Ferramenta «Encher»
+
+f.Ferramenta «Encher» ←
A ferramenta «Encher» inunda unha área contigua do seu debuxo cunha cor da
súa escolla. Ofrécense tres opcións de recheo:
@@ -643,8 +663,8 @@ f.Ferramenta «Encher»
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
-
-g.Ferramenta «Maxia» (efectos especiais)
+
+g.Ferramenta «Maxia» (efectos especiais) ←
A ferramenta Maxia é realmente un conxunto de ferramentas especiais.
Seleccione un dos efectos «máxicos» no selector da dereita. Após,
@@ -695,8 +715,8 @@ g.Ferramenta «Maxia» (efectos especiais)
one large list. See the "Options" documentation.
-
-h.Ferramenta de «Goma» (de borrar)
+
+h.Ferramenta de «Goma» (de borrar) ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -728,11 +748,11 @@ h.Ferramenta de «Goma» (de borrar)
currently-selected tool.
+
+## 2. Outros controis ##
-2. Outros controis
-
-a."Undo" and "Redo" Commands
+a."Undo" and "Redo" Commands ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@@ -747,8 +767,8 @@ a."Undo" and "Redo" Commands
⌨ Nota: Tamén pode premer [Control / ⌘] + [R] no teclado para Refacer.
-
-b.Orde «Novo»
+
+b.Orde «Novo» ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -763,14 +783,14 @@ b.Orde «Novo»
⌨ Nota: Tamén pode premer [Control / ⌘] + [N] no teclado para iniciar un
novo debuxo.
- Special Solid Background Color Choices
+ → Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Pantalla principal > Máis abaixo: Cores > Special color
options for details.
-
- Imaxes «de comezo» e de «modelo»
+
+ Imaxes «de comezo» e de «modelo» ←
o As «imaxes de inicio» poden comportarse como unha páxina dun libro
para colorar: un contorno en branco e negro dunha imaxe, que logo
pode colorar e o contorno negro permanecerá intacto, ou como unha
@@ -803,8 +823,8 @@ b.Orde «Novo»
within Tux Paint, from the 'Open' dialog. See "Open", below.
-
- Erasing Exported Template Images
+
+ → Erasing Exported Template Images ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@@ -820,14 +840,14 @@ b.Orde «Novo»
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
-
+
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
-
-c.Orde «Abrir»
+
+c.Orde «Abrir» ←
Isto amosa unha lista de todas as imaxes que gardou. Se hai máis do que
pode caber na pantalla, use as frechas arriba e abaixo na parte superior e
@@ -881,8 +901,8 @@ c.Orde «Abrir»
diálogo «Abrir».
-
-d.Orde «Gardar»
+
+d.Orde «Gardar» ←
Isto garda a súa imaxe actual.
@@ -902,8 +922,8 @@ d.Orde «Gardar»
⌨ Nota: Tamén pode premer [Control / ⌘] + [S] no teclado para gardar.
-
-e.Orde «Imprimir»
+
+e.Orde «Imprimir» ←
Prema neste botón e imprimirase a súa imaxe.
@@ -913,7 +933,7 @@ e.Orde «Imprimir»
se está a executar Tux Paint en modo de pantalla completa. Vexa a
continuación.
- Desactivar a impresión
+ → Desactivar a impresión ←
Pódese estabelecer a opción «noprint», que desactivará o botón
«Imprimir» de Tux Paint.
@@ -921,8 +941,8 @@ e.Orde «Imprimir»
⚙ Vexa a documentación de «Opcións.
-
- Restrición da impresión
+
+ → Restrición da impresión ←
Pódese estabelecer a opción «printdelay», que só permitirá imprimir
ocasionalmente, cada tantos segundos, segundo o configure vostede.
@@ -934,8 +954,8 @@ e.Orde «Imprimir»
⚙ Vexa a documentación de «Opcións.
-
- Ordes de impresión
+
+ → Ordes de impresión ←
(Só Linux e Unix)
@@ -960,8 +980,8 @@ e.Orde «Imprimir»
⚙ Vexa a documentación de «Opcións.
-
- Axustes de impresión
+
+ → Axustes de impresión ←
(Windows e macOS)
@@ -984,8 +1004,8 @@ e.Orde «Imprimir»
⚙ Vexa a documentación de «Opcións.
-
- Dialogo de opcións da impresora
+
+ → Dialogo de opcións da impresora ←
De xeito predeterminado, Tux Paint só amosa o diálogo da impresora (ou,
en Linux/Unix, executa «altprintcommand»; p. ex.: «kprinter» no canto
@@ -1001,17 +1021,17 @@ e.Orde «Imprimir»
⚙ Vexa a documentación de «Opcións.
+
-
-
-f.Orde «Diapositivas» (en «Abrir»)
+
+f.Orde «Diapositivas» (en «Abrir») ←
O botón «Diapositivas» está dispoñíbel no diálogo «Abrir». Pode usarse para
reproducir unha animación sinxela dentro de Tux Paint ou un diaporama.
Tamén pode exportar un GIF animado baseado nas imaxes escollidas.
- Escolla de imaxes
+ → Escolla de imaxes ←
Cando entra na sección «Diapositivas» de Tux Paint, amosase unha lista
dos seus ficheiros gardados, do mesmo xeito que o diálogo «Abrir».
@@ -1024,8 +1044,8 @@ f.Orde «Diapositivas» (en «Abrir»)
diaporama). Prema de novo se quere engadila ao final da lista.
-
- Estabelecer a velocidade de reprodución
+
+ → Estabelecer a velocidade de reprodución ←
Pódese usar unha escala desprazábel na parte inferior esquerda da
pantalla (xunto ao botón «Reproducir») para axustar a velocidade do
@@ -1039,8 +1059,8 @@ f.Orde «Diapositivas» (en «Abrir»)
se aplica a un GIF animado exportado).
-
- Reprodución en Tux Paint
+
+ → Reprodución en Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@@ -1058,8 +1078,8 @@ f.Orde «Diapositivas» (en «Abrir»)
diaporama.
-
- Exportar un GIF animado
+
+ → Exportar un GIF animado ←
Prema no botón «Exportar GIF» preto da parte inferior dereita para que
Tux Paint xere un ficheiro GIF animado baseado nas imaxes
@@ -1074,14 +1094,14 @@ f.Orde «Diapositivas» (en «Abrir»)
volverá ao diálogo «Diaporama».
-
+
Prema en «Atrás» na pantalla de selección de imaxes de diapositivas para
volver ao diálogo «Abrir».
-
-g.Orde «Saír»
+
+g.Orde «Saír» ←
Ao premer no botón «Saír», pechando a xanela de Tux Paint ou premendo a
tecla [Escape] sairase de Tux Paint.
@@ -1110,8 +1130,8 @@ g.Orde «Saír»
⚙ Vexa a documentación de «Opcións.
-
-h.Silenciar o son
+
+h.Silenciar o son ←
Non hai ningún botón de control na pantalla neste momento, pero ao usar a
secuencia de teclado [Alt] + [S], os efectos de son pódense desactivar e
@@ -1126,11 +1146,11 @@ h.Silenciar o son
⚙ Vexa a documentación de «Opcións.
+
+ ### E. Controlling Tux Paint ###
-E. Controlling Tux Paint
-
-1. Using a Mouse or Trackball
+## 1. Using a Mouse or Trackball ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@@ -1146,7 +1166,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
-a. Scrolling
+# a. Scrolling #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@@ -1159,7 +1179,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
-b. Mouse Accessibility
+# b. Mouse Accessibility #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@@ -1172,7 +1192,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
-2. Using a Tablet or Touchscreen
+## 2. Using a Tablet or Touchscreen ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@@ -1184,7 +1204,7 @@ Some examples:
* Eraser tip
* Multi-touch gestures
-3. Using a Joystick-like Device
+## 3. Using a Joystick-like Device ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@@ -1198,7 +1218,7 @@ to different Tux Paint controls (e.g., acting as the [Escape] key, switching to
the Paint tool, invoking Undo and Redo operations, etc.). See the Options
documentation for more details.
-4. Using the Keyboard
+## 4. Using the Keyboard ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@@ -1207,7 +1227,7 @@ documentation for more details.
III. Carga doutras imaxes en Tux Paint
-A. Overview
+ ### A. Overview ###
O diálogo «Abrir» de Tux Paint só amosa as imaxes que creou con Tux Paint.
Entón, que facer se quere cargar algún outro debuxo ou incluso unha fotografía
@@ -1217,29 +1237,29 @@ Pode simplemente converter a imaxe ao formato que usa Tux Paint –PNG (Portable
Network Graphics – Gráficos de Rede Portátiles)– e colocala no directorio/
cartafol «saved» de Tux Paint. Aquí é onde se atopa (de xeito predeterminado:
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\nome de usuario\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/nome de usuario/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/nome de usuario/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Nota: É tamén dende este cartafol dende onde pode copiar ou abrir imaxes
debuxadas en Tux Paint usando outras aplicacións, aínda que pode usar a opción
«Exportar» do diálogo «Abrir» de Tux Paint para copialas a unha localización de
acceso máis doado e seguro.
-B. Uso do script de importación, «tuxpaint-import»
+ ### B. Uso do script de importación, «tuxpaint-import» ###
Os usuarios de Linux e Unix poden usar o script «tuxpaint-import» que se
instala ao instalar Tux Paint. Emprega algunhas ferramentas NetPBM para
@@ -1270,7 +1290,7 @@ seguintes son a saída do programa mentres funciona.
Agora pode cargar Tux Paint e unha versión desa imaxe orixinal estará
dispoñíbel no diálogo «Abrir». Só ten que premer dúas veces na súa icona.
-C. Importar imaxes manualmente
+ ### C. Importar imaxes manualmente ###
Os usuarios de Windows, macOS e Haiku que queiran importar imaxes arbitrarias a
Tux Paint deben facelo mediante un proceso manual.
@@ -1289,7 +1309,7 @@ resolución coa que se executa Tux Paint, se está en pantalla completa. (Nota:
resolución predeterminada é 800x600.) Vexa «Cálculo das dimensións da imaxe», a
continuación.
-1. Naming the File
+## 1. Naming the File ##
Gardar a imaxe en formato PNG. Recoméndase encarecidamente que nomee o ficheiro
usando a data e hora actuais, xa que esa é a convención que usa Tux Paint:
@@ -1308,7 +1328,7 @@ Exemplo: «20210731110500.png», para o 31 de xullo de 2021 ás 11:05am.
Coloque este ficheiro PNG no seu directorio/cartafol «saved» de Tux Paint. (Ver
arriba.)
-2. Cálculo das dimensións da imaxe
+## 2. Cálculo das dimensións da imaxe ##
É preciso reescribir esta parte da documentación xa que se engadiu a nova
opción «buttonsize». Polo de agora, tente debuxar e gardar unha imaxe dentro de
@@ -1320,7 +1340,7 @@ IV.Máis información
Outra documentación incluída con Tux Paint (que se atopa no cartafol/directorio
«docs») inclúe:
-Using Tux Paint:
+→ Using Tux Paint: ←
+ OPTIONS.html
Instrucións detalladas sobre a liña de ordes e as opcións do ficheiro
de configuración para aqueles que non queiran usar a ferramenta Tux
@@ -1332,8 +1352,8 @@ Using Tux Paint:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-How to extend Tux Paint:
+
+→ How to extend Tux Paint: ←
+ EXTENDING.html
Instrucións detalladas sobre a ampliación de Tux Paint: creación de
pinceis, selos, imaxes de inicio e modelos; engadir fontes; e crear
@@ -1345,8 +1365,8 @@ How to extend Tux Paint:
Notas sobre a creación de imaxes vectoriais en formato SVG para usar en
Tux Paint.
-
-Technical information:
+
+→ Technical information: ←
+ INSTALL.html
Instrucións para compilar e instalar Tux Paint, cando proceda.
+ SIGNALS.html
@@ -1354,8 +1374,8 @@ Technical information:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
-
-Development history and license:
+
+→ Development history and license: ←
+ AUTHORS.txt
Lista de autores e colaboradores.
+ CHANGES.txt
@@ -1363,7 +1383,7 @@ Development history and license:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
-
+
V.Como obter axuda
diff --git a/docs/gl_ES.UTF-8/SIGNALS.txt b/docs/gl_ES.UTF-8/SIGNALS.txt
index a982d65b3..6473461b8 100644
--- a/docs/gl_ES.UTF-8/SIGNALS.txt
+++ b/docs/gl_ES.UTF-8/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responde aos seguintes sinais (que poden enviarse ao proceso do
programa a través de «kill» ou «killall», por exemplo).
-SIGTERM (tamén, [Control] + [C] dende un terminal executando «tuxpaint»)
+→ SIGTERM (tamén, [Control] + [C] dende un terminal executando «tuxpaint») ←
Tux Paint responde coma se se premese o botón «Saír» ou se lle dixera ao
contorno de escritorio que peche Tux Paint (por exemplo, premendo nun botón
@@ -33,8 +33,8 @@ SIGTERM (tamén, [Control] + [C] dende un terminal executando «tuxpaint»)
the [Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responde axustando a súa opción de gardar automaticamente (coma
se fora publicada con «--autosave»), así como a opción de gardar sempre
@@ -54,5 +54,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/gl_ES.UTF-8/SVG.txt b/docs/gl_ES.UTF-8/SVG.txt
index c36dc8c29..b85f7dd9a 100644
--- a/docs/gl_ES.UTF-8/SVG.txt
+++ b/docs/gl_ES.UTF-8/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Open Source
+→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Proprietary
+
+→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/gl_ES.UTF-8/html/EXTENDING.html b/docs/gl_ES.UTF-8/html/EXTENDING.html
index ca5d4aa4a..4dc7ef6ac 100644
--- a/docs/gl_ES.UTF-8/html/EXTENDING.html
+++ b/docs/gl_ES.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the width of the canvas.
@@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the height of the canvas.
@@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
+
Focusing on the top of a starter image stretched to fit the width of the canvas.
@@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
+
Focusing on the bottom of a starter image stretched to fit the width of the canvas.
@@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
+
Focusing on the right of a starter image stretched to fit the height of the canvas.
diff --git a/docs/gl_ES.UTF-8/html/README.html b/docs/gl_ES.UTF-8/html/README.html
index aa7cbc633..2e71c9746 100644
--- a/docs/gl_ES.UTF-8/html/README.html
+++ b/docs/gl_ES.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- 12 de Outubro de 2024
+ 14 de Outubro de 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- New brushes
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Pantalla de título]">
+
B. Pantalla de título
@@ -412,6 +413,7 @@
height="254"
alt=
"[Ferramentas: Pintar, Selo, Liñas, Formas, Texto, Maxia, Etiqueta, Desfacer, Refacer, Borrador, Novo, Abrir, Gardar, Imprimir, Saír]">
+
-
Lado esquerdo: Barra de Ferramentas
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Lenzo]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[Selectores: pinceis, letras, formas, selos]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[Cores: negro, branco, vermello, rosa, laranxa, amarelo, verde, cian, azul, roxo, marrón, gris]">
+
-
@@ -486,13 +491,14 @@
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.)
-
+
+

+
-
On the far right are three special color options:
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Consello de exemplo: «Escolle unha figura. Preme para marcar o centro, arrastra e solta cando teña o tamaño que queiras. Move arredor para invertela, e preme para debuxala.»)">
+
-
diff --git a/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt b/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt
index 711ba7029..8c0a7ee41 100644
--- a/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Tux Paint 0.9.34 Quickstart Guide
-Tools (Drawing)
+ ### Tools (Drawing) ###
-🖌Paint
+## 🖌Paint ##
* Choose a brush on the right.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@@ -10,7 +10,7 @@ Tools (Drawing)
* Choose a color (see "Colors").
* Click/tap and drag in the canvas to paint.
-⌧Selos
+## ⌧Selos ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right.
@@ -27,12 +27,12 @@ Tools (Drawing)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
-⚟Lines
+## ⚟Lines ##
* (See Paint)
* Click/tap and drag to draw a line.
-⭓Shapes
+## ⭓Shapes ##
* Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a corner
@@ -40,7 +40,7 @@ Tools (Drawing)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
-🄰Text
+## 🄰Text ##
* Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@@ -60,7 +60,7 @@ Tools (Drawing)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
-🅰Label
+## 🅰Label ##
* (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@@ -74,7 +74,7 @@ Tools (Drawing)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
-🪣Fill
+## 🪣Fill ##
* Choose a fill mode on the right.
* Choose a color (see "Colors").
@@ -90,7 +90,7 @@ Tools (Drawing)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
-🪄Magic
+## 🪄Magic ##
* Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@@ -101,26 +101,26 @@ Tools (Drawing)
bottom right.
* Some magic tools allow you to choose their color.
-🖓Desfacer
+## 🖓Desfacer ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
-🖒Refacer
+## 🖒Refacer ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
-◪Eraser
+## ◪Eraser ##
* Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
-Tools (Controls)
+ ### Tools (Controls) ###
-🗏New
+## 🗏New ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@@ -131,7 +131,7 @@ Tools (Controls)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
-🕮⮫Open
+## 🕮⮫Open ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@@ -150,7 +150,7 @@ Tools (Controls)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
-🕮⮪Save
+## 🕮⮪Save ##
* Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite the
@@ -158,19 +158,19 @@ Tools (Controls)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
-🖶Print
+## 🖶Print ##
* Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Quit
+## 🗙Quit ##
* Click/tap to quit Tux Paint.
* Shortcut: [Escape]
-Colors
+ ### Colors ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@@ -194,7 +194,7 @@ Colors
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
-Shortcuts while drawing:
+ ### Shortcuts while drawing: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access
diff --git a/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index 656ee667d..a4738c388 100644
--- a/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+----------------------------------------+
-------------------------------------------------------------------------------
-About this 'How-To'
+ ### About this 'How-To' ###
This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
@@ -32,9 +32,9 @@ About this 'How-To'
-------------------------------------------------------------------------------
-Image choice is crucial
+ ### Image choice is crucial ###
- License
+ ## License ##
If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to
@@ -55,7 +55,7 @@ Image choice is crucial
For personal use, any image you can legitimately modify and use for
your own personal use should be fine.
- Image Size and Orientation
+ ## Image Size and Orientation ##
You need an image that has a useful orientation. Perspective is an
enemy. Images that show an object from the corner are difficult to fit
@@ -82,7 +82,7 @@ Image choice is crucial
-------------------------------------------------------------------------------
-Prepare the image
+ ### Prepare the image ###
First of all, be sure to avoid re-saving the image as a JPEG. This causes
quality loss. There is a special tool called jpegtran that lets you crop an
@@ -119,7 +119,7 @@ Prepare the image
-------------------------------------------------------------------------------
-Prepare the mask
+ ### Prepare the mask ###
Get used to doing [Control]-click and [Alt]-click on the thumbnail images
in the layers dialog. You will need this to control what you are looking at
@@ -178,7 +178,7 @@ Prepare the mask
-------------------------------------------------------------------------------
-Replace the fringe and junk pixels
+ ### Replace the fringe and junk pixels ###
Still viewing the mask, select by color. Choose black. Shrink the selection
by several pixels, being sure to NOT shrink from the edges of the mask (the
@@ -240,7 +240,7 @@ Replace the fringe and junk pixels
-------------------------------------------------------------------------------
-Save the image for Tux Paint
+ ### Save the image for Tux Paint ###
It is very easy to ruin your hard work. Image editors can silently destroy
pixels in 0% opaque areas. The conditions under which this happens may vary
@@ -251,7 +251,7 @@ Save the image for Tux Paint
save space (and hide your mistakes), you are almost certain to destroy all
the 0% opaque areas. So here is a better way...
- A Safer Way to Save
+ ## A Safer Way to Save ##
Drag the mask from the layers dialog to the unused portion of the
toolbar (right after the last drawing tool). This will create a new
diff --git a/docs/is_IS.UTF-8/ENVVARS.txt b/docs/is_IS.UTF-8/ENVVARS.txt
index 4343402bc..23728ac0c 100644
--- a/docs/is_IS.UTF-8/ENVVARS.txt
+++ b/docs/is_IS.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.
-Storage-related environment variables
+ ### Storage-related environment variables ###
-HOME
+→ HOME ←
Specifies the user's "home directory", which is used to locate numerous
other files or directories. In some cases, it is utilized as part of a
@@ -30,8 +30,8 @@ HOME
+ The location of a user's private collection of data files — stamps,
brushes, etc. — (versus those available system wide)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@@ -42,8 +42,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@@ -53,18 +53,18 @@ XDG_DATA_HOME
anywhere.
-
-TEMP
+
+→ TEMP ←
Specifies the location where temporary files may be created. Only used by
Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
-Language-related environment variables
+ ### Language-related environment variables ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -73,24 +73,24 @@ LC_MESSAGES
and finally "LANG".
+
-
-Display-related environment variables
+ ### Display-related environment variables ###
The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
to '1' (true) by Tux Paint itself by issuing the command-line option
"--allowscreensaver" or its configuration file counterpart.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@@ -99,5 +99,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").
-
+
diff --git a/docs/is_IS.UTF-8/EXTENDING.txt b/docs/is_IS.UTF-8/EXTENDING.txt
index da3ded2ef..8f7684920 100644
--- a/docs/is_IS.UTF-8/EXTENDING.txt
+++ b/docs/is_IS.UTF-8/EXTENDING.txt
@@ -44,11 +44,11 @@ changing, or removing files where Tux Paint looks for them.
Where Files Go
-Standard Files
+ ### Standard Files ###
Tux Paint looks for its various data files in its 'data' directory.
-Linux and Unix
+→ Linux and Unix ←
Where this directory goes depends on what value was set for "DATA_PREFIX"
when Tux Paint was built. See 'Install documentation' for details.
@@ -62,8 +62,8 @@ Linux and Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint looks for a directory called 'data' in the same directory as the
executable. This is the directory that the installer used when installing
@@ -72,8 +72,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint stores its data files inside the "Tux Paint" application icon
(which is actually a special kind of folder on macOS & Mac OS X before it).
@@ -106,14 +106,14 @@ macOS
Tux Paint.
+
-
-Personal Files
+ ### Personal Files ###
You can also create brushes, stamps, 'starters', templates, and fonts in your
own user account directory (folder) for Tux Paint to find.
-Windows
+→ Windows ←
Your personal Tux Paint folder is stored in your personal "Application
Data". For example, on newer Windows:
@@ -121,8 +121,8 @@ Windows
C:\Users\username\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -130,8 +130,8 @@ macOS
/Users/username/Library/Application Support/TuxPaint/
-
-Linux and Unix
+
+→ Linux and Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/username/.tuxpaint/".
@@ -139,7 +139,7 @@ Linux and Unix
Don't forget the period (".") before the "tuxpaint"!
-
+
To add your own brushes, stamps, 'starters,' templates, and fonts, create
subdirectories under your personal Tux Paint directory named "brushes", "stamps
@@ -160,7 +160,7 @@ partially-transparent!
Greyscale pixels in the brush PNG will be drawn using the currently-selected
color in Tux Paint. Color pixels will be tinted.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -170,7 +170,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -190,17 +190,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Brush Options
+ ### Brush Options ###
Aside from a graphical shape, brushes can also be given other attributes. To do
this, you need to create a 'data file' for the brush.
@@ -212,7 +212,7 @@ The file has the same name as the PNG image, but a ".dat" extension. (e.g.,
"brush.png"'s data file is the text file "brush.dat", found in the same
directory.)
-Brush Spacing
+→ Brush Spacing ←
As of Tux Paint version 0.9.16, you can now specify the spacing for brushes
(that is, how often they are drawn). By default, the spacing will be the
@@ -223,8 +223,8 @@ Brush Spacing
often the brush is drawn.)
-
-Animated Brushes
+
+→ Animated Brushes ←
As of Tux Paint version 0.9.16, you may now create animated brushes. As the
brush is used, each frame of the animation is drawn.
@@ -239,8 +239,8 @@ Animated Brushes
sequentially, also add a line containing "random" to the brush's data file.
-
-Directional Brushes
+
+→ Directional Brushes ←
As of Tux Paint version 0.9.16, you may now create directional brushes. As
the brush is used, different shapes are drawn, depending on the direction
@@ -255,8 +255,8 @@ Directional Brushes
Add a line containing the word "directional" to the brush's data file.
-
-Rotating Brushes
+
+→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@@ -265,8 +265,8 @@ Rotating Brushes
Add a line containing the word "rotate" to the brush's data file.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -274,8 +274,8 @@ Chaotic Brushes
Add a line containing the word "chaotic" to the brush's data file.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -289,7 +289,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Place the brush image PNGs (and any data text files) in the "brushes"
directory.
@@ -305,7 +305,7 @@ subdirectories and sub-subdirectories there to organize the stamps. (For
example, you can have a "holidays" folder with "halloween" and "christmas"
sub-folders.)
-Stamp Images
+ ### Stamp Images ###
Rubber Stamps in Tux Paint can be made up of a number of separate files. The
one file that is required is, of course, the picture itself.
@@ -334,7 +334,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
how to make PNG images which will scale perfectly when used as stamps in Tux
Paint.
-Stamp Descriptive Text
+ ### Stamp Descriptive Text ###
Tux Paint will display descriptive text when a stamp is selected. These are
placed in plain text files with the same name as the PNG or SVG, but with a
@@ -344,7 +344,7 @@ placed in plain text files with the same name as the PNG or SVG, but with a
The first line of the text file will be used as the US English description of
the stamp's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -364,17 +364,17 @@ Localization Support
running in, the US English text is used.
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Stamp Sound Effects
+ ### Stamp Sound Effects ###
Tux Paint can play a sound effect when a stamp is selected. For example, the
sound of a duck quaking when selecting a duck, or a brief piece of music when a
@@ -383,7 +383,7 @@ musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis
"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same
directory.)
-Localization Support
+→ Localization Support ←
For sounds for different locales (e.g., if the sound is someone saying a
word, and you want translated versions of the word said), also create WAV
@@ -400,12 +400,12 @@ Localization Support
the 'default' sound file. (e.g., "stamp.wav")
-
+
💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound',
below.
-Stamp Descriptive Sound
+ ### Stamp Descriptive Sound ###
Tux Paint can also play a descriptive sound when a stamp is selected. For
example, the sound of someone saying the word "duck" when selecting a duck, or
@@ -414,7 +414,7 @@ the name of a musical instrument when one is chosen. Files may be in "WAVE
or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound
is the sound file "stamp_desc.ogg" in the same directory.)
-Localization Support
+→ Localization Support ←
For descriptive sounds for different locales, also create WAV or OGG files
with both "_desc" and the locale's label in the filename, in the form:
@@ -430,9 +430,9 @@ Localization Support
load the 'default' sound file. (e.g., "stamp_desc.wav")
+
-
-Stamp Options
+ ### Stamp Options ###
Aside from a graphical shape, a textual description, a sound effect, and a
descriptive sound, stamps can also be given other attributes. To do this, you
@@ -445,11 +445,11 @@ The file has the same name as the PNG or SVG image, but a ".dat" extension.
(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same
directory.)
-Colored Stamps
+→ Colored Stamps ←
Stamps can be made to be either "colorable" or "tintable."
- Colorable
+ → Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@@ -461,8 +461,8 @@ Colored Stamps
Add a line containing the word "colorable" to the stamp's data file.
-
- Tinted
+
+ → Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@@ -472,14 +472,14 @@ Colored Stamps
Add a line containing the word "tintable" to the stamp's data file.
-
- Tinting Options:
+
+ → Tinting Options: ←
Depending on the contents of your stamp, you might want to have Tux
Paint use one of a number of methods when tinting it. Add one of the
following lines to the stamp's data file:
- Normal tinter — "tinter=normal" (the default)
+ → Normal tinter — "tinter=normal" (the default) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@@ -490,28 +490,28 @@ Colored Stamps
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
-
- Narrow tinter — "tinter=narrow"
+
+ → Narrow tinter — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- 'Any hue' tinter — "tinter=anyhue"
+
+ → 'Any hue' tinter — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Vector tinter — "tinter=vector"
+
+ → Vector tinter — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
+
+
-
-
-
-Unalterable Stamps
+
+→ Unalterable Stamps ←
By default, a stamp can be flipped upside down, shown as a mirror image, or
both. This is done using the control buttons below the stamp selector, at
@@ -528,8 +528,8 @@ Unalterable Stamps
nomirror" to the stamp's data file.
-
-Initial Stamp Size
+
+→ Initial Stamp Size ←
By default, Tux Paint assumes that your stamp is sized appropriately for
unscaled display on a 608x472 canvas. This was the original Tux Paint
@@ -548,17 +548,17 @@ Initial Stamp Size
+ "scale 2.5"
+ "scale 2:5"
-
-Windows Users
+
+→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".dat" extension at the end of the
filename.
+
-
-Pre-Mirrored and Flipped Stamps
+ ### Pre-Mirrored and Flipped Stamps ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@@ -598,7 +598,7 @@ When you use a 'starter' image, make modifications, and save it, the original
'starter' image is not overwritten. Additionally, as you edit your new picture,
the contents of the original 'starter' can affect it.
-Coloring-Book Style Starters
+ ### Coloring-Book Style Starters ###
The most basic kind of 'starter' is similar to a picture in a coloring book.
It's an outline of a shape which you can then color in and add details to. In
@@ -612,7 +612,7 @@ SVG. If saving as a PNG, you may optionally render the image as
black-and-transparent, rather than black-and-white, but (as of Tux Paint
0.9.21) this is not required.
-Scene-Style Starters
+ ### Scene-Style Starters ###
Along with the 'coloring-book' style overlay, you can also provide a separate
background image as part of a 'starter' picture. The overlay acts the same: it
@@ -651,7 +651,7 @@ allows it to continue to affect the drawing even after Tux Paint has been quit,
or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a 'starter' image, it will always be affected by it.)
-Starter Options
+ ### Starter Options ###
Aside from an image, starters can also be given other attributes. To do this,
you need to create a 'data file' for the starter. (Note: Tux Paint prior to
@@ -664,7 +664,7 @@ The file has the same name as the image, but a ".dat" extension. (e.g.,
"starter.png"'s data file is the text file "starter.dat", found in the same
directory.)
-allowscale
+→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@@ -703,8 +703,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
-
-background
+
+→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@@ -722,8 +722,8 @@ background
details.
-
-gravity
+
+→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@@ -747,6 +747,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
+
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@@ -754,6 +755,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
+
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@@ -761,12 +763,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
+
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
+
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@@ -774,13 +778,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
+
Focusing on the right of a starter image stretched to fit the height of the
canvas.
-
+
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@@ -822,7 +827,7 @@ quit, or another picture is loaded or a new image is created. (In other words,
if you base a drawing on a 'template' image, it will always be affected by it.)
-Template Options
+ ### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@@ -963,7 +968,7 @@ layouts).
We'll use the QWERTY keyboard as an example:
-Layout overview file ("qwerty.layout")
+ ### Layout overview file ("qwerty.layout") ###
This is a text file that specifies the other files used to describe the layout
and key mappings.
@@ -981,7 +986,7 @@ seen in the example above.
The "keyboardlist" line describes which layouts to switch to, when the user
clicks the left and right buttons on the keyboard. (See below.)
-Keyboard layout file ("qwerty.h_layout")
+ ### Keyboard layout file ("qwerty.h_layout") ###
This describes how big the keyboard is (as a "width × height" grid), and lists
each key with its numeric keycode (see the "keymap" file, below), the width it
@@ -1045,7 +1050,7 @@ described below.
* 1 — next layout (per the layout file's "keyboardlist" setting)
* 2 — previous layout (per the layout file's "keyboardlist" setting)
-Keymap file ("us-intl-altgr-dead-keys.keymap")
+ ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@@ -1085,7 +1090,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Composemap file ("en_US.UTF-8_Compose")
+ ### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the
@@ -1096,7 +1101,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
-Keysym definitions file ("keysymdef.h")
+ ### Keysym definitions file ("keysymdef.h") ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"
diff --git a/docs/is_IS.UTF-8/FAQ.txt b/docs/is_IS.UTF-8/FAQ.txt
index c25d9a073..08c5f61a6 100644
--- a/docs/is_IS.UTF-8/FAQ.txt
+++ b/docs/is_IS.UTF-8/FAQ.txt
@@ -21,15 +21,15 @@
+------------------------------+
-------------------------------------------------------------------------------
-Drawing-related
+ ### Drawing-related ###
-Fonts I added to Tux Paint only show squares
+→ Fonts I added to Tux Paint only show squares ←
The TrueType Font you're using might have the wrong encoding. If it's
'custom' encoded, for example, you can try running it through FontForge (
http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
(Email us if you need help with special fonts.)
-
-The Rubber Stamp tool is greyed out!
+
+→ The Rubber Stamp tool is greyed out! ←
This means that Tux Paint either couldn't find any stamp images, or was
asked not to load them.
@@ -55,8 +55,8 @@ The Rubber Stamp tool is greyed out!
configuration file.
-
-Stamp outlines are always rectangles
+
+→ Stamp outlines are always rectangles ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@@ -68,13 +68,13 @@ Stamp outlines are always rectangles
in the "tuxpaint.c" file in the "src" directory.
-
+
-------------------------------------------------------------------------------
-Interface Problems
+ ### Interface Problems ###
-Stamp thumbnails in the Stamp Selector look bad
+→ Stamp thumbnails in the Stamp Selector look bad ←
Tux Paint was probably compiled with the faster, lower quality thumbnail
code enabled. Run the command: "tuxpaint --verbose-version" from a command
@@ -89,24 +89,24 @@ Stamp thumbnails in the Stamp Selector look bad
in the "tuxpaint.c" file in the "src" directory.
-
-Pictures in the 'Open' dialog look bad
+
+→ Pictures in the 'Open' dialog look bad ←
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
Stamp Selector look bad", above.
-
-All of the text is in uppercase!
+
+→ All of the text is in uppercase! ←
The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override it with
"--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
yes" in a configuration file.
-
-Tux Paint is in a different language
+
+→ Tux Paint is in a different language ←
Make sure your locale setting is correct. See "Tux Paint won't switch to my
language", below.
-
-Tux Paint won't switch to my language
+
+→ Tux Paint won't switch to my language ←
+ Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your "/etc/
@@ -142,13 +142,13 @@ Tux Paint won't switch to my language
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Printing
+ ### Printing ###
-Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
+→ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) ←
Tux Paint prints by creating a PostScript rendition of the picture and
sending it to an external command. By default, this command is the "lpr"
@@ -167,8 +167,8 @@ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
you will need to go back and alter it to accept PostScript.
-
-I get the message "You can't print yet!" when I go to print
+
+→ I get the message "You can't print yet!" when I go to print ←
The "print delay" option is on. You can only print once every X seconds.
@@ -190,8 +190,8 @@ I get the message "You can't print yet!" when I go to print
allow unlimited printing. (You won't have to wait between prints.)
-
-I simply can't print! The button is greyed out!
+
+→ I simply can't print! The button is greyed out! ←
The "no print" option is on.
@@ -212,41 +212,41 @@ I simply can't print! The button is greyed out!
is checked.
-
+
-------------------------------------------------------------------------------
-Saving
+ ### Saving ###
-Where does Tux Paint save my drawings?
+→ Where does Tux Paint save my drawings? ←
Unless you asked Tux Paint to save into a specific location (using the
"savedir" option), Tux Paint saves into a standard location on your local
drive:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
The images are stored as PNG bitmaps, which most modern programs should be
able to load (image editors, word processors, web browsers, etc.)
-
-Tux Paint always saves over my old picture
+
+→ Tux Paint always saves over my old picture ←
The "save over" option is enabled. (This disables the prompt that would
appear when you click 'Save.')
@@ -271,8 +271,8 @@ Tux Paint always saves over my old picture
Also, see "Tux Paint always saves a new picture!", below.
-
-Tux Paint always saves a new picture!
+
+→ Tux Paint always saves a new picture! ←
The "never save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@@ -297,13 +297,13 @@ Tux Paint always saves a new picture!
Also, see "Tux Paint always saves over my old picture!", above.
-
+
-------------------------------------------------------------------------------
-Audio Problems
+ ### Audio Problems ###
-There's no sound!
+→ There's no sound! ←
+ First, check the obvious:
o Are your speakers connected and turned on?
o Is the volume turned up on your speakers?
@@ -363,8 +363,8 @@ There's no sound!
headers are available!
-
-Tux Paint makes too much noise! Can I turn them off?
+
+→ Tux Paint makes too much noise! Can I turn them off? ←
Yes, there are a number of ways to disable sounds in Tux Paint:
@@ -380,9 +380,9 @@ Tux Paint makes too much noise! Can I turn them off?
o Alternatively, recompile Tux Paint with sound support disabled.
(See above, and the 'Install' documentation.
-
-The stereo panning of sound effects is bothersome; can sound effects be
- monophonic?
+
+→ The stereo panning of sound effects is bothersome; can sound effects be
+ monophonic? ←
Run Tux Paint with the "no stereo" option:
@@ -393,8 +393,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
"Video & Sound") is not checked.
-
-The sound effects sound strange
+
+→ The sound effects sound strange ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@@ -404,16 +404,17 @@ The sound effects sound strange
"tuxpaint --version" to verify), and so on.)
-
+
-------------------------------------------------------------------------------
-Fullscreen Mode Problems
+ ### Fullscreen Mode Problems ###
-When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
+→ When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns
+ black! ←
This is apparently a bug in the SDL library. Sorry.
-
-When I run Tux Paint full-screen, it has large borders around it
+
+→ When I run Tux Paint full-screen, it has large borders around it ←
Linux users - Your X-Window server is probably not set with the ability to
switch to the desired resolution: 800×600. (or whatever resolution you have
@@ -440,8 +441,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
-
-Tux Paint keeps running in Full Screen mode - I want it windowed!
+
+→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
The "fullscreen" option is set.
@@ -464,20 +465,21 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
is not checked.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-
+
-------------------------------------------------------------------------------
-Other Problems
+ ### Other Problems ###
-Tux Paint won't run
+→ Tux Paint won't run ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -503,8 +505,8 @@ Tux Paint won't run
command-line, or "nolockfile=yes" to the configuration file.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -526,8 +528,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-I can't quit Tux Paint
+
+→ I can't quit Tux Paint ←
The "no quit" option is set. This disables the "Quit" button in Tux Paint's
toolbar (greying it out), and prevents Tux Paint from being exited via the
@@ -543,8 +545,8 @@ I can't quit Tux Paint
combination on your keyboard to quit Tux Paint.)
-
-I don't want "no quit" mode enabled!
+
+→ I don't want "no quit" mode enabled! ←
If you're running Tux Paint from a command-line, make sure you're not
giving it a "--noquit" option.
@@ -563,8 +565,8 @@ I don't want "no quit" mode enabled!
Key" (under "Simplification") is not checked.
-
-Tux Paint keeps writing weird messages to the screen / to a text file
+
+→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@@ -578,8 +580,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
in the "tuxpaint.c" file in the "src" directory.
-
-Tux Paint is using options I didn't specify!
+
+→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@@ -656,11 +658,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Help / Contact
+ ### Help / Contact ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:
diff --git a/docs/is_IS.UTF-8/INSTALL.txt b/docs/is_IS.UTF-8/INSTALL.txt
index df7b37575..aa0c60fa5 100644
--- a/docs/is_IS.UTF-8/INSTALL.txt
+++ b/docs/is_IS.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Requirements
-Simple DirectMedia Layer library (libSDL)
+ ### Simple DirectMedia Layer library (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Other Libraries
+## Other Libraries ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
-libPNG
+→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Linux/Unix only)
+
+→ libpaper (Linux/Unix only) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@@ -92,8 +92,8 @@ libpaper (Linux/Unix only)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
-
-SVG graphics support
+
+→ SVG graphics support ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
- librsvg-2 & libCairo2 (newer libraries)
+ → librsvg-2 & libCairo2 (newer libraries) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o These also depend on the following:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Older SVG libraries
+
+ → Older SVG libraries ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o These also depend on the following:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Animated GIF Export feature
+
+→ Animated GIF Export feature ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@@ -133,8 +133,8 @@ Animated GIF Export feature
https://github.com/ImageOptim/libimagequant
-
-NetPBM Tools (optional) No longer used, by default
+
+→ NetPBM Tools (optional) No longer used, by default ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@@ -144,7 +144,7 @@ NetPBM Tools (optional) No longer used, by default
http://netpbm.sourceforge.net/
-
+
Compiling and Installation
@@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
júlí 10, 2022 Shin-ichi TOYAMA
-Compiling Set-Up
+## Compiling Set-Up ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@@ -207,7 +207,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@@ -264,7 +264,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -365,7 +365,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -393,7 +393,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Building the Tux Paint Windows Installer
+## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Running the Tux Paint Windows Installer
+## Running the Tux Paint Windows Installer ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
-Changing the Settings Using the Shortcut
+## Changing the Settings Using the Shortcut ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@@ -460,7 +460,7 @@ pushed the "Apply" button!).
When you have finished, click "OK."
-If Something Goes Wrong
+## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -474,9 +474,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compiling:
+## Compiling: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -487,7 +487,8 @@ shell prompt (e.g., "$"):
$ make
-Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+## Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@@ -495,7 +496,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
-Disabling Sound at Compile-time
+## Disabling Sound at Compile-time ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@@ -503,12 +504,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
-Other options
+## Other options ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
-If you get errors
+## If you get errors ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@@ -516,7 +517,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
-Installng
+## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@@ -542,7 +543,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Changing Where Things Go
+# Changing Where Things Go #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@@ -551,48 +552,48 @@ default, set to "/usr/local".
Other variables are:
-BIN_PREFIX
+→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
júní 5, 2022 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Prerequisites
+## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -628,7 +629,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -640,7 +641,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -654,7 +655,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-How to Build
+## How to Build ##
Simply, run:
@@ -668,7 +669,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Known Issues
+## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -685,7 +686,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Old Versions of macOS
+## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -725,7 +726,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Recompiling MacPorts
+## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -749,7 +750,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Building a Universal Binary
+## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -763,7 +764,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
mars 29, 2023 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -772,7 +773,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Prerequisites
+## Prerequisites ##
You will need recent versions of:
@@ -797,7 +798,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Building
+## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -826,36 +827,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
maí 7, 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Prerequisites
+## Prerequisites ##
Install the required develop packages in Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Building
+## Building ##
make PREFIX=/boot/home/config/non-packaged
-Tux Paint Stamps
+## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -868,9 +870,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
-Windows
+ ### Windows ###
-Using the Uninstaller
+## Using the Uninstaller ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@@ -879,19 +881,19 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
When it has finished, click on the close button.
-Using the Control Panel
+## Using the Control Panel ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
"/Library/Application Support/TuxPaint/" (all users) and
"/Users/username/Library/Application Support/TuxPaint/" (individual users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/is_IS.UTF-8/MAGIC-API.txt b/docs/is_IS.UTF-8/MAGIC-API.txt
index d3dddc66e..7543f6084 100644
--- a/docs/is_IS.UTF-8/MAGIC-API.txt
+++ b/docs/is_IS.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
útgáfa 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Höfundarréttur © 2007-2024 eftir various contributors; sjá AUTHORS-skrá.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Til upplýsingar ##
-Til upplýsingar
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,38 +1131,38 @@ Additionally, other Tux Paint developers and users can be found on the
Orðasafn
-&
+→ & ←
See "'og' merki"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "punktur"
-
-`
+
+→ ` ←
See "grave"
-
-alfa
+
+→ alfa ←
See "RGBA"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / bakslag
+
+→ backquote / bakslag ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bitar
+
+→ bitar ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1171,69 +1171,69 @@ bitar
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "bæti"
-
-blátt
+
+→ blátt ←
See "RGBA"
-
-boole gildið 'eða'
+
+→ boole gildið 'eða' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bitar"
-
-bæti
+
+→ bæti ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bitar"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-draga
+
+→ draga ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ smellur
+ sleppa
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1241,169 +1241,169 @@ element
+ punktur
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-fjölvi
+
+→ fjölvi ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-frumgerð
+
+→ frumgerð ←
See "C function prototype"
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-gildi
+
+→ gildi ←
See "HSV"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-grænt
+
+→ grænt ←
See "RGBA"
-
-.h / haus / header file
+
+→ .h / haus / header file ←
See "C header file"
-
-hnit
+
+→ hnit ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-litblær
+
+→ litblær ←
See "HSV"
-
-línulegt
+
+→ línulegt ←
Definition not yet presented.
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-'og' merki (bendlar)
+
+→ 'og' merki (bendlar) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-'og' merki (bitwise operator)
+
+→ 'og' merki (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bitar"
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1411,38 +1411,38 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-punktur
+
+→ punktur ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-rautt / RGB
+
+→ rautt / RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-rás
+
+→ rás ←
Definition not yet presented.
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1454,12 +1454,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1470,51 +1470,51 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-sleppa
+
+→ sleppa ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ smellur
+ draga
-
-smellur
+
+→ smellur ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ draga
+ sleppa
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1523,14 +1523,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1539,37 +1539,37 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "'og' merki"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-stærðir
+
+→ stærðir ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-svörun
+
+→ svörun ←
Definition not yet presented.
-
-tap
+
+→ tap ←
See "smellur"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,35 +1588,35 @@ Uint8
+ integer
+ unsigned
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-viðfang
+
+→ viðfang ←
A value sent to a function.
-
-(w,h)
+
+→ (w,h) ←
See "stærðir"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "hnit"
-
-|
+
+→ | ←
See "boole gildið 'eða'"
-
-óundirritað
+
+→ óundirritað ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1631,5 +1631,5 @@ WAVE
+ Uint32
+ integer
-
+
diff --git a/docs/is_IS.UTF-8/OPTIONS.txt b/docs/is_IS.UTF-8/OPTIONS.txt
index b197cdbfb..32d7e2560 100644
--- a/docs/is_IS.UTF-8/OPTIONS.txt
+++ b/docs/is_IS.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Options Documentation
+ ### Options Documentation ###
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -45,11 +45,11 @@ each time you start it up.
The file is simply a plain text file containing the options you want enabled:
-Linux and Unix Users
+ ### Linux and Unix Users ###
/home/username/.tuxpaintrc
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -57,11 +57,11 @@ at:
/etc/tuxpaint/tuxpaint.conf
-macOS Users
+ ### macOS Users ###
/Users/username/Library/Application Support/TuxPaint/tuxpaint.cfg
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -69,14 +69,14 @@ at:
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Windows Users
+ ### Windows Users ###
C:\Users\username\AppData\Roaming\TuxPaint\tuxpaint.cfg
You can use NotePad or WordPad to create this file. Be sure to save it as Plain
Text, and make sure the filename doesn't have ".txt" at the end...
-System-Wide Configuration File
+## System-Wide Configuration File ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -84,7 +84,7 @@ at:
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -97,11 +97,11 @@ Available Options
The following settings can be set in the configuration file. (Command-line
settings will override these. See the "Command-Line Options" section, below.)
-Video/Sound
+ ### Video/Sound ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Run the program in full screen mode, rather than in a window.
@@ -110,15 +110,15 @@ fullscreen=yes
overridden by the command-line option "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Run the program in full screen mode. Additionally, assume the screen's
current resolution (set by the operating system).
-
-windowsize=SIZE
+
+→ windowsize=SIZE ←
Run the program at a different size (in windowed mode) or at a different
screen resolution (in fullscreen mode), rather than the default (usually
@@ -140,8 +140,8 @@ windowsize=SIZE
of the display, Tux Paint will fall back to the display's dimensions.
-
-orient=portrait
+
+→ orient=portrait ←
Swaps the width/height options given to Tux Paint, useful for rotating the
window on portait displays, such as a tablet PC that's in tablet
@@ -152,16 +152,16 @@ orient=portrait
be overridden by the command-line option "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
When running Tux Paint in fullscreen mode, this assumes the screen's
current resolution (overriding any "windowsize" option), as set by the
operating system.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -174,11 +174,11 @@ allowscreensaver=yes
command-line option "--disablescreensaver".
+
+## Sound ##
-Sound
-
-nosound=yes
+→ nosound=yes ←
Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to
reenable sounds if they were disabled using this option.)
@@ -188,8 +188,8 @@ nosound=yes
cases, may be overridden by the command-line option "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Disable stereo panning support. (Useful for users with hearing impairment
in one ear, or places where a single speaker or headphone is being used.)
@@ -199,11 +199,11 @@ nostereo=yes
cases, may be overridden by the command-line option "--stereo".
+
+## Interface Size ##
-Interface Size
-
-buttonsize=SIZE
+→ buttonsize=SIZE ←
Set the pixel size of buttons in Tux Paint's user interface (overriding the
default of "48"). Useful when using very high-density displays or coarse
@@ -224,8 +224,8 @@ buttonsize=SIZE
stderr.)
-
-colorsrows=ROWS
+
+→ colorsrows=ROWS ←
How many rows of color palette buttons to show; useful when using a large
color palette (see "colorfile", above), and/or for use with coarse input
@@ -233,13 +233,13 @@ colorsrows=ROWS
and "3".
+
+ ### Mouse/Keyboard ###
-Mouse/Keyboard
+## Cursor ##
-Cursor
-
-nofancycursors=yes
+→ nofancycursors=yes ←
This disables the fancy mouse pointer shapes in Tux Paint, and uses your
environment's normal mouse pointer.
@@ -253,8 +253,8 @@ nofancycursors=yes
"--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
This completely hides the mouse pointer shapes in Tux Paint.
@@ -265,11 +265,11 @@ hidecursor=yes
both cases, may be overridden by the command-line option "--showcursor".
+
+## Keyboard ##
-Keyboard
-
-noshortcuts=yes
+→ noshortcuts=yes ←
This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for
a new image, etc.)
@@ -282,11 +282,11 @@ noshortcuts=yes
both cases, may be overridden by the command-line option "--shortcuts".
+
+## Mouse ##
-Mouse
-
-grab=yes
+→ grab=yes ←
Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse
is confined to Tux Paint's window, and nearly all keyboard input is passed
@@ -301,8 +301,8 @@ grab=yes
cases, may be overridden by the command-line option "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
This disables support for the wheel on mice that have it. (Normally, the
wheel will scroll the selector menu on the right.)
@@ -312,8 +312,8 @@ nowheelmouse=yes
In both cases, may be overridden by the command-line option "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could
also be used for clicking. In version 0.9.15, it was changed so that only
@@ -330,13 +330,13 @@ nobuttondistinction=yes
command-line option "--buttondistinction".
+
+ ### Simplification ###
-Simplification
+## Interface Simplification ##
-Interface Simplification
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Disable the rotation step of the 'Shape' tool. Click, drag and release is
all that will be needed to draw a shape.
@@ -347,8 +347,8 @@ simpleshapes=yes
"--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
In this mode, much simpler outlines and 'rubber-band' lines are displayed
when using the Lines, Shapes, Stamps and Eraser tools.
@@ -361,8 +361,8 @@ nooutlines=yes
both cases, may be overridden by the command-line option "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
All text will be rendered only in uppercase (e.g., "Brush" will be
"BRUSH"). Useful for children who can read, but who have only learned
@@ -373,11 +373,11 @@ uppercase=yes
both cases, may be overridden by the command-line option "--mixedcase".
+
+## Initial Stamp Size ##
-Initial Stamp Size
-
-stampsize=SIZE
+→ stampsize=SIZE ←
Use this option to force Tux Paint to set the starting size of all stamps.
The SIZE value should be between 0 (smallest) and 10 (largest). The size is
@@ -387,11 +387,11 @@ stampsize=SIZE
Specify "default" to let Tux Paint decide (its standard behavior).
+
+## Control Simplification ##
-Control Simplification
-
-noquit=yes
+→ noquit=yes ←
Disable the on-screen "Quit" button and prevent the [Escape] key from
quitting Tux Paint.
@@ -408,8 +408,8 @@ noquit=yes
cases, may be overridden by the command-line option "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
This option tells Tux Paint to not load any rubber stamp images, which in
turn ends up disabling the Stamps tool.
@@ -422,8 +422,8 @@ nostamps=yes
cases, may be overridden by the command-line option "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Some images in the Stamps tool can be mirrored, flipped, and/or have their
size changed. This option disables the controls, and only provides the
@@ -435,8 +435,8 @@ nostampcontrols=yes
"--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
This disables the rotation step of the Stamps tool, immediately placing the
stamp in its regular orientation (with any flipping or mirroring applied)
@@ -451,8 +451,8 @@ nostamprotation=yes
"--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Some Magic tools have the option of acting like a paintbrush, or affecting
the entire canvas at once. This option disables the controls, and only
@@ -464,8 +464,8 @@ nomagiccontrols=yes
"--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Some Magic tools offer various size settings. This option disables the
sizing control, and only provides the tools' default sizes. (Some plugins
@@ -477,8 +477,8 @@ nomagicsizes=yes
In both cases, may be overridden by the command-line option "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -494,8 +494,8 @@ ungroupmagictools=yes
option "--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Disable the control buttons shown when using the Shapes tool that allow
changing how shapes are drawn — centered around the initial mouse click, or
@@ -507,8 +507,8 @@ noshapecontrols=yes
"--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Disables the Label tool: the tool that allows text entry which can be
edited later.
@@ -518,8 +518,8 @@ nolabel=yes
cases, may be overridden by the command-line option "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Disables the brush spacing option of the Paint and Lines tools. The
brushes' default spacings will be used.
@@ -533,8 +533,8 @@ nobrushspacing=yes
"--brushspacing".
-
-complexity=COMPLEXITY
+
+→ complexity=COMPLEXITY ←
Sets the complexity (expertise) level of Tux Paint, which can either
disable some Magic tools, or cause them to operate differently. (For
@@ -544,18 +544,18 @@ complexity=COMPLEXITY
The COMPLEXITY value may be one of:
- advanced (the default)
+ → advanced (the default) ←
"Advanced" — For users familiar with Tux Paint and who can operate more
complex tools.
-
- beginner
+
+ → beginner ←
"Beginner" — For users comfortable with Tux Paint, but where complex
tools may cause confusion or frustration.
-
- novice
+
+ → novice ←
"Novice" — For first-time Tux Paint users, users inexperienced with
computers, or those with special accessibility needs.
-
+
📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
Consult the individual Magic tools' documentation.
@@ -565,8 +565,8 @@ complexity=COMPLEXITY
may be overridden by the command-line option "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Disables the ability to create a new Template image (based on a saved
drawing) from within the Open dialog.
@@ -580,8 +580,8 @@ notemplateexport=yes
option "--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Disables the ability to erase saved drawings via the "Erase" button on the
Open dialog, or exported Template images (based on a saved drawing) via the
@@ -595,13 +595,13 @@ noerase=yes
cases, may be overridden by the command-line option "--erase".
+
+ ### Languages ###
-Languages
+## Language ##
-Language
-
-lang=LANGUAGE
+→ lang=LANGUAGE ←
Run Tux Paint in one of the supported languages. Possible choices for
LANGUAGE currently include:
@@ -863,8 +863,8 @@ lang=LANGUAGE
+-----------------------------------------------------------------+
-
---locale LOCALE
+
+→ --locale LOCALE ←
Run Tux Paint in one of the support languages. See the "Choosing a
Different Language" section below for the locale strings (e.g., "de_DE" for
@@ -875,8 +875,8 @@ lang=LANGUAGE
setting, if possible.)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
For stamps that can be mirrored, this option sets them to their mirrored
shape by default.
@@ -890,11 +890,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Fonts ##
-Fonts
-
-sysfonts=yes
+→ sysfonts=yes ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -905,8 +905,8 @@ sysfonts=yes
both cases, may be overridden by the command-line option "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts
directory, including locale-specific ones (e.g., the one for Tibetan, which
@@ -922,8 +922,8 @@ alllocalefonts=yes
command-line option "--currentlocalefont".
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -933,19 +933,19 @@ uifont=FONT NAME
standard behavior).
+
+ ### Printing ###
-Printing
+## Print Permissions ##
-Print Permissions
-
-noprint=yes
+→ noprint=yes ←
Disable the printing feature.
-
-printdelay=SECONDS
+
+→ printdelay=SECONDS ←
Restrict printing so that printing can occur only once every SECONDS
seconds.
@@ -955,11 +955,11 @@ printdelay=SECONDS
overridden by the command-line option "--printdelay=0".
+
+## Show Printer Dialog ##
-Show Printer Dialog
-
-altprint=always
+→ altprint=always ←
This causes Tux Paint to always show the printer dialog (or, on Linux/Unix,
run the "altprintcommand") when the 'Print' button is clicked. In other
@@ -967,8 +967,8 @@ altprint=always
need to hold [Alt] every time.
-
-altprint=never
+
+→ altprint=never ←
This prevents Tux Paint from ever showing the printer dialog (or, on Linux/
Unix, run the "altprintcommand") when the 'Print' button is clicked. In
@@ -976,8 +976,8 @@ altprint=never
'Print' button.
-
-altprint=mod
+
+→ altprint=mod ←
This is the normal, default behavior. Tux Paint shows a printer dialog (or,
on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed
@@ -985,11 +985,11 @@ altprint=mod
prints without showing a dialog.
+
+## Save Printer Configuration ##
-Save Printer Configuration
-
- printcfg=yes
+ → printcfg=yes ←
(Windows and macOS only)
@@ -1009,11 +1009,11 @@ Save Printer Configuration
"--noprintcfg".
+
+ ## Print Commands ##
- Print Commands
-
- printcommand=COMMAND
+ → printcommand=COMMAND ←
(Linux and Unix only)
@@ -1030,8 +1030,8 @@ Save Printer Configuration
to version 0.9.15, you will need to change it.
-
- altprintcommand=COMMAND
+
+ → altprintcommand=COMMAND ←
(Linux and Unix only)
@@ -1046,11 +1046,11 @@ Save Printer Configuration
kprinter
+
+ ## Paper Size ##
- Paper Size
-
- papersize=PAPERSIZE
+ → papersize=PAPERSIZE ←
(Platforms that use Tux Paint's internal PostScript generator — not
Windows, macOS, BeOS, or Haiku.)
@@ -1067,40 +1067,40 @@ Save Printer Configuration
esheet.
+
+ ### Saving ###
- Saving
+ ## Save Over Earlier Work ##
- Save Over Earlier Work
-
- saveover=yes
+ → saveover=yes ←
This disables the "Save over the old version...?" prompt when saving an
existing file. With this option, the older version will always be
replaced by the new version, automatically.
-
- saveover=new
+
+ → saveover=new ←
This also disables the "Save over the old version...?" prompt when
saving an existing file. This option, however, will always save a new
file, rather than overwrite the older version.
-
- saveover=ask
+
+ → saveover=ask ←
(This option is redundant, since this is the default.) When saving an
existing drawing, you will be first asked whether to save over the
older version or not.
+
+ ## Starting Out ##
- Starting Out
-
- startblank=yes
+ → startblank=yes ←
This causes Tux Paint to display a blank canvas when it first starts
up, rather than loading the last image that was being edited.
@@ -1111,8 +1111,8 @@ Save Printer Configuration
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Places the blank color options in the New dialog at the end, so that
any Starters and/or Templates are shown first.
@@ -1123,30 +1123,30 @@ Save Printer Configuration
command-line option "--newcolorsfirst".
+
+ ## Save and Export Directories ##
- Save and Export Directories
-
- savedir=DIRECTORY
+ → savedir=DIRECTORY ←
Use this option to change where Tux Paint's "saved" directory/folder is
located, which is where Tux Paint saves and opens pictures.
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/username/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/username/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.
@@ -1159,8 +1159,8 @@ Save Printer Configuration
Example: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORY
+
+ → exportdir=DIRECTORY ←
Use this option to change where Tux Paint exports files — single
images, or animated GIF slideshows — for external use.
@@ -1199,11 +1199,11 @@ Save Printer Configuration
Example: exportdir=/home/penguin/TuxPaintExports
+
+ ## More Saving Options ##
- More Saving Options
-
- nosave=yes
+ → nosave=yes ←
This disables Tux Paint's ability to save files (and therefore disables
the on-screen "Save" button). It can be used in situations where the
@@ -1214,8 +1214,8 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--save".
-
- autosave=yes
+
+ → autosave=yes ←
This prevents Tux Paint from asking whether you want to save the
current picture when quitting, and assumes you do.
@@ -1226,8 +1226,8 @@ Save Printer Configuration
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
This reverses the sorting of the Open and Slideshow dialogs, placing
the newest images at the top of the list.
@@ -1238,13 +1238,13 @@ Save Printer Configuration
command-line option "--noreversesort".
+
+ ### Data ###
- Data
+ ## Lockfile ##
- Lockfile
-
- nolockfile=yes
+ → nolockfile=yes ←
By default, Tux Paint uses what's known as a 'lockfile' to prevent it
from being launched more than once in 30 seconds. (This is to avoid
@@ -1266,11 +1266,11 @@ Save Printer Configuration
"--lockfile".
+
+ ## Data Directory ##
- Data Directory
-
- datadir=DIRECTORY
+ → datadir=DIRECTORY ←
Use this option to change where Tux Paint looks for personal data files
(brushes, stamps, starters, templates, and fonts specific to the
@@ -1282,15 +1282,15 @@ Save Printer Configuration
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
/home/username/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\username\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/username/Library/Application Support/TuxPaint/
-
+
📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting
or default as for "savedir" to search for data files. As of version
@@ -1302,11 +1302,11 @@ Save Printer Configuration
Example: datadir=/home/johnny/tuxpaint-data/
+
+ ## Color Palette File ##
- Color Palette File
-
- colorfile=FILENAME
+ → colorfile=FILENAME ←
You may override Tux Paint's default color palette by creating a plain
ASCII text file that describes the colors you want, and pointing to
@@ -1333,23 +1333,23 @@ Save Printer Configuration
byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".
+
+ ### Accessibility ###
- Accessibility
+ ## Mouse ##
- Mouse
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
In this mode, instead of clicking, dragging and releasing (e.g., to
draw), you click, move, and click again to end the motion.
+
+ ## Keyboard ##
- Keyboard
-
- keyboard=yes
+ → keyboard=yes ←
This allows the keyboard arrow keys to be used to control the mouse
pointer. (e.g., for mouseless environments, or handicapped/
@@ -1388,18 +1388,18 @@ Save Printer Configuration
both cases, may be overridden by the command-line option "--mouse".
+
+ ## Onscreen Keyboard ##
- Onscreen Keyboard
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Presents a clickable on-screen keyboard when using the Text and Label
tools.
-
- onscreen-keyboard-layout=LAYOUTNAME
+
+ → onscreen-keyboard-layout=LAYOUTNAME ←
Selects the initial layout for the on-screen keyboard when using the
Text and Label tools.
@@ -1407,8 +1407,8 @@ Save Printer Configuration
setting both is redundant.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Disables the possibility for changing the layout of the on-screen
keyboard when using the Text and Label tools, useful for simplifying
@@ -1422,191 +1422,191 @@ Save Printer Configuration
by the command-line option "--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Main Device ##
- Main Device
-
- joystick-dev=N
+ → joystick-dev=N ←
Specify which joystick device should be used by Tux Paint. Default
value is 0 (the first joystick).
-
- joystick-slowness=SPEED
+
+ → joystick-slowness=SPEED ←
Sets a delay at each axis motion, allowing to slow the joystick.
Allowed values are from 0 to 500. Default value is 15.
-
- joystick-threshold=THRESHOLD
+
+ → joystick-threshold=THRESHOLD ←
Sets the minimum level of axis motion to start moving the pointer.
Allowed values are from 0 to 32766. Default value is 3200.
-
- joystick-maxsteps=STEPS
+
+ → joystick-maxsteps=STEPS ←
Sets the maximum pixels the pointer will move at once. Allowed values
are from 1 to 7. Default value is 7.
+
+ ## Hat ##
- Hat
-
- joystick-hat-slowness=SPEED
+ → joystick-hat-slowness=SPEED ←
Sets a delay at each automatic motion, allowing to slow the speed of
the hat. Allowed values are from 0 to 500. Default value is 15.
-
- joystick-hat-timeout=MILLISECONDS
+
+ → joystick-hat-timeout=MILLISECONDS ←
Sets the delay after wich the pointer will start moving automatically
if the hat is keeped pushed. Allowed values are from 0 to 3000. Default
value is 1000.
+
+ ## Buttons to Disable ##
- Buttons to Disable
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
A set of joystick button numbers, as seen by SDL, that should be
ignored. Otherwise, unless they are used by one of the "joystick-btn-"
options above, buttons will be seen as a mouse left-click.
+
+## Button Shortcuts ##
-Button Shortcuts
-
- joystick-btn-escape=BUTTON NUMBER
+ → joystick-btn-escape=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be used
to generate a escape event. Useful to dismiss dialogs and quit.
-
- joystick-btn-brush=BUTTON NUMBER
+
+ → joystick-btn-brush=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the brush tool.
-
- joystick-btn-stamp=BUTTON NUMBER
+
+ → joystick-btn-stamp=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the stamp tool.
-
- joystick-btn-lines=BUTTON NUMBER
+
+ → joystick-btn-lines=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the lines tool.
-
- joystick-btn-shapes=BUTTON NUMBER
+
+ → joystick-btn-shapes=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the shapes tool.
-
- joystick-btn-text=BUTTON NUMBER
+
+ → joystick-btn-text=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the text tool.
-
- joystick-btn-label=BUTTON NUMBER
+
+ → joystick-btn-label=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the label tool.
-
- joystick-btn-fill=BUTTON NUMBER
+
+ → joystick-btn-fill=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the fill tool.
-
- joystick-btn-magic=BUTTON NUMBER
+
+ → joystick-btn-magic=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select the magic tool.
-
- joystick-btn-undo=BUTTON NUMBER
+
+ → joystick-btn-undo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to invoke the undo tool.
-
- joystick-btn-redo=BUTTON NUMBER
+
+ → joystick-btn-redo=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select redo tool.
-
- joystick-btn-eraser=BUTTON NUMBER
+
+ → joystick-btn-eraser=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select eraser tool.
-
- joystick-btn-new=BUTTON NUMBER
+
+ → joystick-btn-new=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for creating a new drawing.
-
- joystick-btn-open=BUTTON NUMBER
+
+ → joystick-btn-open=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for opening an existing drawing.
-
- joystick-btn-save=BUTTON NUMBER
+
+ → joystick-btn-save=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to save the drawing.
-
- joystick-btn-pgsetup=BUTTON NUMBER
+
+ → joystick-btn-pgsetup=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the page setup dialog for printing.
-
- joystick-btn-print=BUTTON NUMBER
+
+ → joystick-btn-print=BUTTON NUMBER ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to print.
-
+
Overriding System Config. Options
@@ -1631,7 +1631,7 @@ Button Shortcuts
Options may also be issued on the command-line when you go to launch Tux
Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--WIDTHxHEIGHT
--orient=portrait
@@ -1713,13 +1713,14 @@ Button Shortcuts
--reversesort
--lang LANGUAGE
--colorfile FILE
+ ←
These enable or correspond to the configuration file options described
above.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1760,14 +1761,15 @@ Button Shortcuts
--save
--noautosave
--noreversesort
+ ←
These options can be used to override any settings made in the
configuration file. (If the option isn't set in the configuration file
(s), no overriding option is necessary.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1776,52 +1778,52 @@ Button Shortcuts
Linux) — if it exists — will be used.
+
-
- Command-Line Informational Options
+ ### Command-Line Informational Options ###
The following options display some informative text on the screen. Tux
Paint doesn't actually start up and run afterwards, however.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Show brief license information about copying Tux Paint.
-
- --usage
+
+ → --usage ←
Display the list of available command-line options.
-
- --help
+
+ → --help ←
Display brief help on using Tux Paint.
-
- --lang help
+
+ → --lang help ←
Display a list of available languages in Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Display list of attached joysticks available to Tux Paint.
-
+
Choosing a Different Language
@@ -1835,7 +1837,7 @@ Button Shortcuts
Use the option "--lang help" to list the language options available.
- Available Languages
+ ### Available Languages ###
+-------------------------------------------------------------------------+
| | Language | Language | Input Method |
@@ -2136,7 +2138,7 @@ Button Shortcuts
can be used to cycle through the supported input methods while the Text
tool is active.
- Setting Your Environment's Locale
+ ### Setting Your Environment's Locale ###
Changing your locale will affect much of your environment.
@@ -2147,7 +2149,7 @@ Button Shortcuts
If you haven't already set your environment's locale, the following will
briefly explain how:
- Linux/Unix Users
+ ## Linux/Unix Users ##
First, be sure the locale you want to use is enabled by editing the file "/
etc/locale.gen" on your system and then running the program "locale-gen" as
@@ -2175,7 +2177,7 @@ Button Shortcuts
setenv LANG es_ES ; \
tuxpaint
- Windows Users
+ ## Windows Users ##
Tux Paint will recognize the current locale and use the appropriate files
by default. So this section is only for people trying different languages.
@@ -2200,7 +2202,7 @@ Button Shortcuts
+ Edit the value of the parameter "LANG" (create it, if it doesn't
exists).
- Special Fonts
+ ### Special Fonts ###
Some languages require special fonts be installed. These font files (which
are in TrueType format (TTF)), are much too large to include with the Tux
diff --git a/docs/is_IS.UTF-8/PNG.txt b/docs/is_IS.UTF-8/PNG.txt
index 47d9dddca..4f3042029 100644
--- a/docs/is_IS.UTF-8/PNG.txt
+++ b/docs/is_IS.UTF-8/PNG.txt
@@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
-How To Make PNGs
+ ### How To Make PNGs ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
-GIMP & Krita
+→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
+
+→ Command-line Tools ←
-Command-line Tools
-
- NetPBM
+ → NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@@ -58,8 +58,8 @@ Command-line Tools
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@@ -68,11 +68,11 @@ Command-line Tools
or to learn more, visit https://jpegclub.org/.
+
-
-
-Proprietary Software for Windows
+
+→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -80,13 +80,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Macintosh Users
+
+→ Macintosh Users ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/is_IS.UTF-8/README.txt b/docs/is_IS.UTF-8/README.txt
index 1ab74da5a..ce3859734 100644
--- a/docs/is_IS.UTF-8/README.txt
+++ b/docs/is_IS.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
version 0.9.34
- A simple drawing program for children
+ ## A simple drawing program for children ##
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
- október 12, 2024
+ október 14, 2024
+-------------------------------------------------+
| Table of Contents |
@@ -44,7 +44,7 @@
I. About Tux Paint
-A. What Is "Tux Paint"?
+ ### A. What Is "Tux Paint"? ###
Tux Paint is a free drawing program designed for young children (kids ages 3
and up). It has a simple, easy-to-use interface, fun sound effects, and an
@@ -52,43 +52,43 @@ encouraging cartoon mascot who helps guide children as they use the program. It
provides a blank canvas and a variety of drawing tools to help your child be
creative.
-B. Objectives
+ ### B. Objectives ###
-Easy and Fun
+→ Easy and Fun ←
Tux Paint is meant to be a simple drawing program for young children. It is
not meant as a general-purpose drawing tool. It is meant to be fun and easy
to use. Sound effects and a cartoon character help let the user know what's
going on, and keeps them entertained. There are also extra-large
cartoon-style mouse pointer shapes.
-
-Extensibility
+
+→ Extensibility ←
Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped
in and pulled out. For example, a teacher can drop in a collection of
animal shapes and ask their students to draw an ecosystem. Each shape can
have a sound which is played, and textual facts which are displayed, when
the child selects the shape.
-
-Portability
+
+→ Portability ←
Tux Paint is portable among various computer platforms: Windows, Macintosh,
Linux, etc. The interface looks the same among them all. Tux Paint runs
suitably well on older systems, and can be built to run better on slow
systems.
-
-Simplicity
+
+→ Simplicity ←
There is no direct access to the computer's underlying intricacies. The
current image is kept when the program quits, and reappears when it is
restarted. Saving images requires no need to create filenames or use the
keyboard. Opening an image is done by selecting it from a collection of
thumbnails. Access to other files on the computer is restricted.
-
-Accessibility
+
+→ Accessibility ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
+
-
-C. License
+ ### C. License ###
Tux Paint is an Open Source project, Free Software released under the GNU
General Public License (GPL). It is free, and the 'source code' behind the
@@ -97,62 +97,76 @@ parts of the program in their own GPL'd software.)
See COPYING.txt for the full text of the GPL license.
-D. What's New in Tux Paint version 0.9.34?
+ ### D. What's New in Tux Paint version 0.9.34? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
See CHANGES.txt for the complete list of changes.
II. Using Tux Paint
-A. Launching Tux Paint
+ ### A. Launching Tux Paint ###
-1. Linux/Unix Users
+## 1. Linux/Unix Users ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@@ -163,7 +177,7 @@ Alternatively, you can run the following command at a shell prompt (e.g., "$"):
If any errors occur, they will be displayed on the terminal (to STDERR).
-2. Windows Users
+## 2. Windows Users ##
[Tux Paint Icon]
Tux Paint
@@ -187,13 +201,14 @@ installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
-3. macOS Users
+## 3. macOS Users ##
Simply double-click the "Tux Paint" icon.
[Title screen]
+
-B. Title Screen
+ ### B. Title Screen ###
When Tux Paint first loads, a title/credits screen will appear.
@@ -201,20 +216,22 @@ Once loading is complete, press a key or click or tap in the Tux Paint window
to continue. (Or, after about 5 seconds, the title screen will go away
automatically.)
-C. Main Screen
+ ### C. Main Screen ###
The main screen is divided into the following sections:
[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser,
New, Open, Save, Print, Quit]
-Left Side: Toolbar
+
+→ Left Side: Toolbar ←
The toolbar contains the drawing and editing controls.
-
+
[Canvas]
-Middle: Drawing Canvas
+
+→ Middle: Drawing Canvas ←
The largest part of the screen, in the center, is the drawing canvas. This
is, obviously, where you draw!
@@ -225,9 +242,10 @@ Middle: Drawing Canvas
more details.
-
+
[Selectors - Brushes, Letters, Shapes, Stamps]
-Right Side: Selector
+
+→ Right Side: Selector ←
Depending on the current tool, the selector shows different things. e.g.,
when the Paint Brush or Line tool is selected, it shows the various brushes
@@ -236,10 +254,11 @@ Right Side: Selector
various fonts.
-
+
[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue,
Purple, Brown, Grey]
-Lower: Colors
+
+→ Lower: Colors ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@@ -295,23 +314,24 @@ Lower: Colors
documentation.
-
+
(Example tip: 'Pick a shape. Click to pick the center, drag, then let go
when it is the size you want. Move around to rotate it, and click to draw
it.')
-Bottom: Help Area
+
+→ Bottom: Help Area ←
At the very bottom of the screen, Tux, the Linux Penguin, provides tips and
other information while you use Tux Paint.
+
+ ### D. Available Tools ###
-D. Available Tools
+## 1. Drawing Tools ##
-1. Drawing Tools
-
-a. "Paint" Tool (Brush)
+a. "Paint" Tool (Brush) ←
The Paint Brush tool lets you draw freehand, using various brushes (chosen
in the Selector on the right) and colors (chosen in the Color palette
@@ -353,8 +373,8 @@ a. "Paint" Tool (Brush)
the brush spacing controls. See the "Options" documentation.
-
-b."Stamp" Tool (Rubber Stamps)
+
+b."Stamp" Tool (Rubber Stamps) ←
The Stamp tool is like a set of rubber stamps or stickers. It lets you
paste pre-drawn or photographic images (like a picture of a horse, or a
@@ -364,12 +384,12 @@ b."Stamp" Tool (Rubber Stamps)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
- Stamp Categories
+ → Stamp Categories ←
There can be numerous categories of stamps (e.g., animals, plants,
outer space, vehicles, people, etc.). Use the Left and Right arrows
near the bottom of the Selector to cycle through the collections.
-
- Stamp Rotation
+
+ → Stamp Rotation ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@@ -386,8 +406,8 @@ b."Stamp" Tool (Rubber Stamps)
0.9.29.
-
- Stamp Controls
+
+ → Stamp Controls ←
Prior to 'stamping' an image onto your drawing, various effects can
sometimes be applied (depending on the stamp):
@@ -406,8 +426,8 @@ b."Stamp" Tool (Rubber Stamps)
Options" documentation.
-
- Stamp Sounds
+
+ → Stamp Sounds ←
Different stamps can have different sound effects and/or descriptive
(spoken) sounds. Buttons in the Help Area at the lower left (near Tux,
@@ -415,11 +435,11 @@ b."Stamp" Tool (Rubber Stamps)
descriptive sounds for the currently-selected stamp.
+
-
-
-c."Lines" Tool
+
+c."Lines" Tool ←
This tool lets you draw straight lines using the various brushes and colors
you normally use with the Paint Brush.
@@ -444,8 +464,8 @@ c."Lines" Tool
to learn more.
-
-d."Shapes" Tool
+
+d."Shapes" Tool ←
This tool lets you draw some simple filled, and un-filled shapes.
@@ -453,15 +473,15 @@ d."Shapes" Tool
Use the options at the bottom right to choose the shape tool's behavior:
- Shapes from center
+ → Shapes from center ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
-
- Shapes from corner
+
+ → Shapes from corner ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@@ -469,7 +489,7 @@ d."Shapes" Tool
📜 This option was added starting with Tux Paint version 0.9.25.
-
+
⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols"
option), the controls will not be presented, and the "shapes from center"
@@ -487,7 +507,7 @@ d."Shapes" Tool
Let go of the mouse when you're done stretching.
- Normal Shapes Mode
+ → Normal Shapes Mode ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@@ -497,8 +517,8 @@ d."Shapes" Tool
color.
-
- Simple Shapes Mode
+
+ → Simple Shapes Mode ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@@ -507,11 +527,11 @@ d."Shapes" Tool
("simpleshapes") option.
+
-
-
-e."Text" and "Label" Tools
+
+e."Text" and "Label" Tools ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@@ -532,7 +552,7 @@ e."Text" and "Label" Tools
causes the current line of text to move to that location (where you can
continue editing it).
- "Text" versus "Label"
+ → "Text" versus "Label" ←
The Text tool is the original text-entry tool in Tux Paint. Text
entered using this tool can't be modified or moved later, since it
@@ -567,8 +587,8 @@ e."Text" and "Label" Tools
option).
-
- International Character Input
+
+ → International Character Input ←
Tux Paint allows inputting characters in different languages. Most
Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some
@@ -594,8 +614,8 @@ e."Text" and "Label" Tools
trying to type.
-
- On-screen Keyboard
+
+ → On-screen Keyboard ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@@ -605,11 +625,11 @@ e."Text" and "Label" Tools
information.
+
-
-
-f."Fill" Tool
+
+f."Fill" Tool ←
The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a
color of your choice. Three fill options are offered:
@@ -632,8 +652,8 @@ f."Fill" Tool
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
-
-g."Magic" Tool (Special Effects)
+
+g."Magic" Tool (Special Effects) ←
The Magic tool is actually a set of special tools. Select one of the
'magic' effects from the selector on the right. Then, depending on the
@@ -683,8 +703,8 @@ g."Magic" Tool (Special Effects)
one large list. See the "Options" documentation.
-
-h."Eraser" Tool
+
+h."Eraser" Tool ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -716,11 +736,11 @@ h."Eraser" Tool
currently-selected tool.
+
+## 2. Other Controls ##
-2. Other Controls
-
-a."Undo" and "Redo" Commands
+a."Undo" and "Redo" Commands ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@@ -736,8 +756,8 @@ a."Undo" and "Redo" Commands
⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo.
-
-b."New" Command
+
+b."New" Command ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -751,14 +771,14 @@ b."New" Command
⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a
new drawing.
- Special Solid Background Color Choices
+ → Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Main Screen > Lower: Colors > Special color options for
details.
-
- 'Starter' & Template Images
+
+ 'Starter' & Template Images ←
o 'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color in,
and the black outline remains intact — or like a 3D photograph,
@@ -788,8 +808,8 @@ b."New" Command
within Tux Paint, from the 'Open' dialog. See "Open", below.
-
- Erasing Exported Template Images
+
+ → Erasing Exported Template Images ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@@ -805,14 +825,14 @@ b."New" Command
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
-
+
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
-
-c."Open" Command
+
+c."Open" Command ←
This shows you a list of all of the pictures you've saved. If there are
more than can fit on the screen, use the up and down arrows at the top and
@@ -864,8 +884,8 @@ c."Open" Command
the 'Open' dialog.
-
-d."Save" Command
+
+d."Save" Command ←
This saves your current picture.
@@ -885,8 +905,8 @@ d."Save" Command
⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save.
-
-e."Print" Command
+
+e."Print" Command ←
Click this button and your picture will be printed!
@@ -895,7 +915,7 @@ e."Print" Command
this may not work if you're running Tux Paint in fullscreen mode. See
below.
- Disabling Printing
+ → Disabling Printing ←
The "noprint" option can be set, which will disable Tux Paint's 'Print'
button.
@@ -903,8 +923,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Restricting Printing
+
+ → Restricting Printing ←
The "printdelay" option can be set, which will only allow occasional
printing — once every so many seconds, as configured by you.
@@ -915,8 +935,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printing Commands
+
+ → Printing Commands ←
(Linux and Unix only)
@@ -942,8 +962,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Settings
+
+ → Printer Settings ←
(Windows and macOS)
@@ -965,8 +985,8 @@ e."Print" Command
⚙ See the "Options" documentation.
-
- Printer Dialog Options
+
+ → Printer Dialog Options ←
By default, Tux Paint only shows the printer dialog (or, on Linux/Unix,
runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the
@@ -981,17 +1001,17 @@ e."Print" Command
⚙ See the "Options" documentation.
+
-
-
-f."Slides" Command (under "Open")
+
+f."Slides" Command (under "Open") ←
The 'Slides' button is available in the 'Open' dialog. It can be used to
play a simple animation within Tux Paint, or a slideshow of pictures. It
can also export an animated GIF based on the chosen images.
- Chosing pictures
+ → Chosing pictures ←
When you enter the 'Slides' section of Tux Paint, it displays a list of
your saved files, just like the 'Open' dialog.
@@ -1005,8 +1025,8 @@ f."Slides" Command (under "Open")
list.
-
- Set playback speed
+
+ → Set playback speed ←
A sliding scale at the lower left of the screen (next to the 'Play'
button) can be used to adjust the speed of the slideshow or animated
@@ -1019,8 +1039,8 @@ f."Slides" Command (under "Open")
does not apply to an exported animated GIF.)
-
- Playback in Tux Paint
+
+ → Playback in Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@@ -1036,8 +1056,8 @@ f."Slides" Command (under "Open")
the slideshow and return to the slideshow image selection screen.
-
- Exporting an animated GIF
+
+ → Exporting an animated GIF ←
Click the 'GIF Export' button near the lower right to have Tux Paint
generate an animated GIF file based on the selected images.
@@ -1051,14 +1071,14 @@ f."Slides" Command (under "Open")
return you to the 'Slideshow' dialog.
-
+
Click 'Back' in the slideshow image selection screen to return to the
'Open' dialog.
-
-g."Quit" Command
+
+g."Quit" Command ←
Clicking the 'Quit' button, closing the Tux Paint window, or pushing the
[Escape] key will quit Tux Paint.
@@ -1085,8 +1105,8 @@ g."Quit" Command
⚙ See the "Options" documentation.
-
-h.Sound Muting
+
+h.Sound Muting ←
There is no on-screen control button at this time, but by using the [Alt] +
[S] keyboard sequence, sound effects can be disabled and re-enabled (muted
@@ -1099,11 +1119,11 @@ h.Sound Muting
⚙ See the "Options" documentation.
+
+ ### E. Controlling Tux Paint ###
-E. Controlling Tux Paint
-
-1. Using a Mouse or Trackball
+## 1. Using a Mouse or Trackball ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@@ -1119,7 +1139,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
-a. Scrolling
+# a. Scrolling #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@@ -1132,7 +1152,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
-b. Mouse Accessibility
+# b. Mouse Accessibility #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@@ -1145,7 +1165,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
-2. Using a Tablet or Touchscreen
+## 2. Using a Tablet or Touchscreen ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@@ -1157,7 +1177,7 @@ Some examples:
* Eraser tip
* Multi-touch gestures
-3. Using a Joystick-like Device
+## 3. Using a Joystick-like Device ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@@ -1171,7 +1191,7 @@ to different Tux Paint controls (e.g., acting as the [Escape] key, switching to
the Paint tool, invoking Undo and Redo operations, etc.). See the Options
documentation for more details.
-4. Using the Keyboard
+## 4. Using the Keyboard ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@@ -1180,7 +1200,7 @@ documentation for more details.
III. Loading Other Pictures into Tux Paint
-A. Overview
+ ### A. Overview ###
Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So
what do you do if you want to load some other drawinng or even a photograph
@@ -1190,29 +1210,29 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Note: It is also from this folder that you can copy or open pictures drawn in
Tux Paint using other applications, though the 'Export' option from Tux Paint's
'Open' dialog can be used to copy them to a location that's easier and safer to
access.
-B. Using the import script, "tuxpaint-import"
+ ### B. Using the import script, "tuxpaint-import" ###
Linux and Unix users can use the "tuxpaint-import" shell script which gets
installed when you install Tux Paint. It uses some NetPBM tools to convert the
@@ -1243,7 +1263,7 @@ following two lines are output from the program while it's working.
Now you can load Tux Paint, and a version of that original picture will be
available under the 'Open' dialog. Just double-click its icon!
-C. Importing Pictures Manually
+ ### C. Importing Pictures Manually ###
Windows, macOS, and Haiku users who wish to import arbitrary images into Tux
Paint must do so via a manual process.
@@ -1261,7 +1281,7 @@ Paint's canvas size. This size depends on the size of the Tux Paint window, or
resolution at which Tux Paint is run, if in fullscreen. (Note: The default
resolution is 800x600.) See "Calculating Image Dimensions", below.
-1. Naming the File
+## 1. Naming the File ##
Save the picture in PNG format. It is highly recommended that you name the
filename using the current date and time, since that's the convention Tux Paint
@@ -1280,7 +1300,7 @@ Example: "20210731110500.png", for July 31, 2021 at 11:05am.
Place this PNG file in your Tux Paint "saved" directory/folder. (See above.)
-2. Calculating Image Dimensions
+## 2. Calculating Image Dimensions ##
This part of the documentation needs to be rewritten, since the new
"buttonsize" option was added. For now, try drawing and saving an image within
@@ -1293,7 +1313,7 @@ IV.Further Reading
Other documentation included with Tux Paint (found in the "docs" folder/
directory) includes:
-Using Tux Paint:
+→ Using Tux Paint: ←
+ OPTIONS.html
Detailed instructions on command-line and configuration-file options,
for those who don't want to use the Tux Paint Config. tool to manage
@@ -1304,8 +1324,8 @@ Using Tux Paint:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-How to extend Tux Paint:
+
+→ How to extend Tux Paint: ←
+ EXTENDING.html
Detailed instructions on extending Tux Paint: creating brushes, stamps,
starters, and templates; adding fonts; and creating new on-screen
@@ -1316,8 +1336,8 @@ How to extend Tux Paint:
+ SVG.html
Notes on creating SVG format vector images for use in Tux Paint.
-
-Technical information:
+
+→ Technical information: ←
+ INSTALL.html
Instructions for compiling and installing Tux Paint, when applicable.
+ SIGNALS.html
@@ -1325,8 +1345,8 @@ Technical information:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
-
-Development history and license:
+
+→ Development history and license: ←
+ AUTHORS.txt
List of authors and contributors.
+ CHANGES.txt
@@ -1334,7 +1354,7 @@ Development history and license:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
-
+
V.How to Get Help
diff --git a/docs/is_IS.UTF-8/SIGNALS.txt b/docs/is_IS.UTF-8/SIGNALS.txt
index 7ecf25953..8d30d0e6a 100644
--- a/docs/is_IS.UTF-8/SIGNALS.txt
+++ b/docs/is_IS.UTF-8/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
-SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
+→ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@@ -32,8 +32,8 @@ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
the [Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/is_IS.UTF-8/SVG.txt b/docs/is_IS.UTF-8/SVG.txt
index 700f0b748..8fc1dc9e0 100644
--- a/docs/is_IS.UTF-8/SVG.txt
+++ b/docs/is_IS.UTF-8/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Open Source
+→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Proprietary
+
+→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/is_IS.UTF-8/html/EXTENDING.html b/docs/is_IS.UTF-8/html/EXTENDING.html
index e25d7422d..bbf9edd57 100644
--- a/docs/is_IS.UTF-8/html/EXTENDING.html
+++ b/docs/is_IS.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the width of the canvas.
@@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the height of the canvas.
@@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
+
Focusing on the top of a starter image stretched to fit the width of the canvas.
@@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
+
Focusing on the bottom of a starter image stretched to fit the width of the canvas.
@@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
+
Focusing on the right of a starter image stretched to fit the height of the canvas.
diff --git a/docs/is_IS.UTF-8/html/README.html b/docs/is_IS.UTF-8/html/README.html
index 251aa65a6..3a1e1f05c 100644
--- a/docs/is_IS.UTF-8/html/README.html
+++ b/docs/is_IS.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- október 12, 2024
+ október 14, 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- New brushes
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Title screen]">
+
B. Title Screen
@@ -412,6 +413,7 @@
height="254"
alt=
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]">
+
-
Left Side: Toolbar
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Canvas]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[Selectors - Brushes, Letters, Shapes, Stamps]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
+
-
@@ -486,13 +491,14 @@
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.)
-
+
+

+
-
On the far right are three special color options:
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Example tip: 'Pick a shape. Click to pick the center, drag, then let go when it is the size you want. Move around to rotate it, and click to draw it.')">
+
-
diff --git a/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt b/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt
index 4289957ce..78cfaa942 100644
--- a/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Tux Paint 0.9.34 Quickstart Guide
-Tools (Drawing)
+ ### Tools (Drawing) ###
-🖌Paint
+## 🖌Paint ##
* Choose a brush on the right.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@@ -10,7 +10,7 @@ Tools (Drawing)
* Choose a color (see "Colors").
* Click/tap and drag in the canvas to paint.
-⌧Stamps
+## ⌧Stamps ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right.
@@ -27,12 +27,12 @@ Tools (Drawing)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
-⚟Lines
+## ⚟Lines ##
* (See Paint)
* Click/tap and drag to draw a line.
-⭓Shapes
+## ⭓Shapes ##
* Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a corner
@@ -40,7 +40,7 @@ Tools (Drawing)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
-🄰Text
+## 🄰Text ##
* Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@@ -60,7 +60,7 @@ Tools (Drawing)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
-🅰Label
+## 🅰Label ##
* (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@@ -74,7 +74,7 @@ Tools (Drawing)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
-🪣Fill
+## 🪣Fill ##
* Choose a fill mode on the right.
* Choose a color (see "Colors").
@@ -90,7 +90,7 @@ Tools (Drawing)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
-🪄Magic
+## 🪄Magic ##
* Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@@ -101,26 +101,26 @@ Tools (Drawing)
bottom right.
* Some magic tools allow you to choose their color.
-🖓Undo
+## 🖓Undo ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
-🖒Redo
+## 🖒Redo ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
-◪Eraser
+## ◪Eraser ##
* Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
-Tools (Controls)
+ ### Tools (Controls) ###
-🗏New
+## 🗏New ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@@ -131,7 +131,7 @@ Tools (Controls)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
-🕮⮫Open
+## 🕮⮫Open ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@@ -150,7 +150,7 @@ Tools (Controls)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
-🕮⮪Save
+## 🕮⮪Save ##
* Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite the
@@ -158,19 +158,19 @@ Tools (Controls)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
-🖶Print
+## 🖶Print ##
* Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Quit
+## 🗙Quit ##
* Click/tap to quit Tux Paint.
* Shortcut: [Escape]
-Colors
+ ### Colors ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@@ -194,7 +194,7 @@ Colors
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
-Shortcuts while drawing:
+ ### Shortcuts while drawing: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access
diff --git a/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index e0bee3849..1221596c5 100644
--- a/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -18,7 +18,7 @@
+----------------------------------+
-------------------------------------------------------------------------------
-この解説について
+ ### この解説について ###
この解説では、デジカメ写真などのJPEG画像をもとに、PNG形式で、高いクォリティ
の Tux Paint 用スタンプを作成したいという場合を想定しています。クォリティに
@@ -31,9 +31,9 @@
-------------------------------------------------------------------------------
-使用する画像の選択
+ ### 使用する画像の選択 ###
- 著作権
+ ## 著作権 ##
Tux Paint の開発者に作品を提供して公式プロジェクトへの採用を検討しても
らいたい場合や、Tux Paint に独自の画像を同梱して配布したい場合には、Tux
@@ -54,7 +54,7 @@
個人的に使用する場合は、合法的に修正して使用できる画像であれば問題あり
ません。
- 画像の大きさと向き
+ ## 画像の大きさと向き ##
使いやすい向きの画像が必要で、遠近感のあるものは禁物です。被写体を隅の
方から見たような画像は、お絵かきに使うには向いていません。一般的には、
@@ -82,7 +82,7 @@
-------------------------------------------------------------------------------
-画像の準備
+ ### 画像の準備 ###
まず、画像をJPEGで保存し直さないようにしてください。これは品質低下の原因と
なります。jpegtranという特別なツールを使えば、品質を維持したまま画像を切り
@@ -119,7 +119,7 @@
-------------------------------------------------------------------------------
-マスクの設定
+ ### マスクの設定 ###
レイヤーダイアログのサムネイル画像を [Control] キーを押しながらクリックした
り、[Alt] キーを押しながらクリックしたりすることに慣れておきましょう。これ
@@ -178,7 +178,7 @@
-------------------------------------------------------------------------------
-縁取りと不要なピクセルの除去
+ ### 縁取りと不要なピクセルの除去 ###
マスクをを表示しながら、黒で領域を選択した後、選択範囲を数ピクセル縮小しま
す。ただし、マスクの端から縮小しないように注意してください(縮小すること
@@ -237,7 +237,7 @@
-------------------------------------------------------------------------------
-Tux Paint 用の画像の保存
+ ### Tux Paint 用の画像の保存 ###
せっかくの労作も簡単にダメになることがあります。画像編集ソフトは、不透明度0
%の領域のピクセルを勝手にで破棄することがあります。この現象が発生する条件
@@ -248,7 +248,7 @@ Tux Paint 用の画像の保存
縮小する必要がある場合、ほぼ確実に 0%の不透明部分をすべて破壊してし
まうことになります。そこで、もっと良い方法があります。
- より安全な保存方法
+ ## より安全な保存方法 ##
マスクをレイヤーダイアログからツールバーの未使用部分(最後の描画ツール
の直後)にドラッグします。これで、マスクデータを含む1つのレイヤーからな
diff --git a/docs/ja_JP.UTF-8/ENVVARS.txt b/docs/ja_JP.UTF-8/ENVVARS.txt
index e8a2b4f23..cc104c617 100644
--- a/docs/ja_JP.UTF-8/ENVVARS.txt
+++ b/docs/ja_JP.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.
-Storage-related environment variables
+ ### Storage-related environment variables ###
-HOME
+→ HOME ←
Specifies the user's "home directory", which is used to locate numerous
other files or directories. In some cases, it is utilized as part of a
@@ -30,8 +30,8 @@ HOME
+ The location of a user's private collection of data files — stamps,
brushes, etc. — (versus those available system wide)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@@ -42,8 +42,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@@ -53,18 +53,18 @@ XDG_DATA_HOME
anywhere.
-
-TEMP
+
+→ TEMP ←
Specifies the location where temporary files may be created. Only used by
Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
-Language-related environment variables
+ ### Language-related environment variables ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -73,24 +73,24 @@ LC_MESSAGES
and finally "LANG".
+
-
-Display-related environment variables
+ ### Display-related environment variables ###
The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
to '1' (true) by Tux Paint itself by issuing the command-line option
"--allowscreensaver" or its configuration file counterpart.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@@ -99,5 +99,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").
-
+
diff --git a/docs/ja_JP.UTF-8/EXTENDING.txt b/docs/ja_JP.UTF-8/EXTENDING.txt
index a9d3d00c8..52e80a08a 100644
--- a/docs/ja_JP.UTF-8/EXTENDING.txt
+++ b/docs/ja_JP.UTF-8/EXTENDING.txt
@@ -44,11 +44,11 @@ changing, or removing files where Tux Paint looks for them.
Where Files Go
-Standard Files
+ ### Standard Files ###
Tux Paint looks for its various data files in its 'data' directory.
-Linux and Unix
+→ Linux and Unix ←
Where this directory goes depends on what value was set for "DATA_PREFIX"
when Tux Paint was built. See 'Install documentation' for details.
@@ -62,8 +62,8 @@ Linux and Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint looks for a directory called 'data' in the same directory as the
executable. This is the directory that the installer used when installing
@@ -72,8 +72,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint stores its data files inside the "Tux Paint" application icon
(which is actually a special kind of folder on macOS & Mac OS X before it).
@@ -106,14 +106,14 @@ macOS
Tux Paint.
+
-
-Personal Files
+ ### Personal Files ###
You can also create brushes, stamps, 'starters', templates, and fonts in your
own user account directory (folder) for Tux Paint to find.
-Windows
+→ Windows ←
Your personal Tux Paint folder is stored in your personal "Application
Data". For example, on newer Windows:
@@ -121,8 +121,8 @@ Windows
C:\Users\ユーザー名\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -130,8 +130,8 @@ macOS
/Users/ユーザー名/Library/Application Support/TuxPaint/
-
-Linux and Unix
+
+→ Linux and Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/ユーザー名/.tuxpaint/".
@@ -139,7 +139,7 @@ Linux and Unix
Don't forget the period (".") before the "tuxpaint"!
-
+
To add your own brushes, stamps, 'starters,' templates, and fonts, create
subdirectories under your personal Tux Paint directory named "brushes", "stamps
@@ -160,7 +160,7 @@ partially-transparent!
Greyscale pixels in the brush PNG will be drawn using the currently-selected
color in Tux Paint. Color pixels will be tinted.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -170,7 +170,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -190,17 +190,17 @@ Localization Support
running in, the US English text is used.
-
-Windows のユーザー
+
+→ Windows のユーザー ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Brush Options
+ ### Brush Options ###
Aside from a graphical shape, brushes can also be given other attributes. To do
this, you need to create a 'data file' for the brush.
@@ -212,7 +212,7 @@ The file has the same name as the PNG image, but a ".dat" extension. (e.g.,
"brush.png"'s data file is the text file "brush.dat", found in the same
directory.)
-ブラシの描画間隔
+→ ブラシの描画間隔 ←
As of Tux Paint version 0.9.16, you can now specify the spacing for brushes
(that is, how often they are drawn). By default, the spacing will be the
@@ -223,8 +223,8 @@ directory.)
often the brush is drawn.)
-
-Animated Brushes
+
+→ Animated Brushes ←
As of Tux Paint version 0.9.16, you may now create animated brushes. As the
brush is used, each frame of the animation is drawn.
@@ -239,8 +239,8 @@ Animated Brushes
sequentially, also add a line containing "random" to the brush's data file.
-
-Directional Brushes
+
+→ Directional Brushes ←
As of Tux Paint version 0.9.16, you may now create directional brushes. As
the brush is used, different shapes are drawn, depending on the direction
@@ -255,8 +255,8 @@ Directional Brushes
Add a line containing the word "directional" to the brush's data file.
-
-Rotating Brushes
+
+→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@@ -265,8 +265,8 @@ Rotating Brushes
Add a line containing the word "rotate" to the brush's data file.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -274,8 +274,8 @@ Chaotic Brushes
Add a line containing the word "chaotic" to the brush's data file.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -289,7 +289,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Place the brush image PNGs (and any data text files) in the "brushes"
directory.
@@ -305,7 +305,7 @@ subdirectories and sub-subdirectories there to organize the stamps. (For
example, you can have a "holidays" folder with "halloween" and "christmas"
sub-folders.)
-Stamp Images
+ ### Stamp Images ###
Rubber Stamps in Tux Paint can be made up of a number of separate files. The
one file that is required is, of course, the picture itself.
@@ -334,7 +334,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
how to make PNG images which will scale perfectly when used as stamps in Tux
Paint.
-Stamp Descriptive Text
+ ### Stamp Descriptive Text ###
Tux Paint will display descriptive text when a stamp is selected. These are
placed in plain text files with the same name as the PNG or SVG, but with a
@@ -344,7 +344,7 @@ placed in plain text files with the same name as the PNG or SVG, but with a
The first line of the text file will be used as the US English description of
the stamp's image. It must be encoded in UTF-8.
-Localization Support
+→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@@ -364,17 +364,17 @@ Localization Support
running in, the US English text is used.
-
-Windows のユーザー
+
+→ Windows のユーザー ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
+
-
-Stamp Sound Effects
+ ### Stamp Sound Effects ###
Tux Paint can play a sound effect when a stamp is selected. For example, the
sound of a duck quaking when selecting a duck, or a brief piece of music when a
@@ -383,7 +383,7 @@ musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis
"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same
directory.)
-Localization Support
+→ Localization Support ←
For sounds for different locales (e.g., if the sound is someone saying a
word, and you want translated versions of the word said), also create WAV
@@ -400,12 +400,12 @@ Localization Support
the 'default' sound file. (e.g., "stamp.wav")
-
+
💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound',
below.
-Stamp Descriptive Sound
+ ### Stamp Descriptive Sound ###
Tux Paint can also play a descriptive sound when a stamp is selected. For
example, the sound of someone saying the word "duck" when selecting a duck, or
@@ -414,7 +414,7 @@ the name of a musical instrument when one is chosen. Files may be in "WAVE
or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound
is the sound file "stamp_desc.ogg" in the same directory.)
-Localization Support
+→ Localization Support ←
For descriptive sounds for different locales, also create WAV or OGG files
with both "_desc" and the locale's label in the filename, in the form:
@@ -430,9 +430,9 @@ Localization Support
load the 'default' sound file. (e.g., "stamp_desc.wav")
+
-
-Stamp Options
+ ### Stamp Options ###
Aside from a graphical shape, a textual description, a sound effect, and a
descriptive sound, stamps can also be given other attributes. To do this, you
@@ -445,11 +445,11 @@ The file has the same name as the PNG or SVG image, but a ".dat" extension.
(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same
directory.)
-Colored Stamps
+→ Colored Stamps ←
Stamps can be made to be either "colorable" or "tintable."
- Colorable
+ → Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@@ -461,8 +461,8 @@ Colored Stamps
Add a line containing the word "colorable" to the stamp's data file.
-
- Tinted
+
+ → Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@@ -472,14 +472,14 @@ Colored Stamps
Add a line containing the word "tintable" to the stamp's data file.
-
- Tinting Options:
+
+ → Tinting Options: ←
Depending on the contents of your stamp, you might want to have Tux
Paint use one of a number of methods when tinting it. Add one of the
following lines to the stamp's data file:
- Normal tinter — "tinter=normal" (the default)
+ → Normal tinter — "tinter=normal" (the default) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@@ -490,28 +490,28 @@ Colored Stamps
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
-
- Narrow tinter — "tinter=narrow"
+
+ → Narrow tinter — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- 'Any hue' tinter — "tinter=anyhue"
+
+ → 'Any hue' tinter — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Vector tinter — "tinter=vector"
+
+ → Vector tinter — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
+
+
-
-
-
-Unalterable Stamps
+
+→ Unalterable Stamps ←
By default, a stamp can be flipped upside down, shown as a mirror image, or
both. This is done using the control buttons below the stamp selector, at
@@ -528,8 +528,8 @@ Unalterable Stamps
nomirror" to the stamp's data file.
-
-スタンプの初期サイズ
+
+→ スタンプの初期サイズ ←
By default, Tux Paint assumes that your stamp is sized appropriately for
unscaled display on a 608x472 canvas. This was the original Tux Paint
@@ -548,17 +548,17 @@ Unalterable Stamps
+ "scale 2.5"
+ "scale 2:5"
-
-Windows のユーザー
+
+→ Windows のユーザー ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".dat" extension at the end of the
filename.
+
-
-Pre-Mirrored and Flipped Stamps
+ ### Pre-Mirrored and Flipped Stamps ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@@ -598,7 +598,7 @@ When you use a 'starter' image, make modifications, and save it, the original
'starter' image is not overwritten. Additionally, as you edit your new picture,
the contents of the original 'starter' can affect it.
-Coloring-Book Style Starters
+ ### Coloring-Book Style Starters ###
The most basic kind of 'starter' is similar to a picture in a coloring book.
It's an outline of a shape which you can then color in and add details to. In
@@ -612,7 +612,7 @@ SVG. If saving as a PNG, you may optionally render the image as
black-and-transparent, rather than black-and-white, but (as of Tux Paint
0.9.21) this is not required.
-Scene-Style Starters
+ ### Scene-Style Starters ###
Along with the 'coloring-book' style overlay, you can also provide a separate
background image as part of a 'starter' picture. The overlay acts the same: it
@@ -651,7 +651,7 @@ allows it to continue to affect the drawing even after Tux Paint has been quit,
or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a 'starter' image, it will always be affected by it.)
-Starter Options
+ ### Starter Options ###
Aside from an image, starters can also be given other attributes. To do this,
you need to create a 'data file' for the starter. (Note: Tux Paint prior to
@@ -664,7 +664,7 @@ The file has the same name as the image, but a ".dat" extension. (e.g.,
"starter.png"'s data file is the text file "starter.dat", found in the same
directory.)
-allowscale
+→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@@ -703,8 +703,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
-
-background
+
+→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@@ -722,8 +722,8 @@ background
details.
-
-gravity
+
+→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@@ -747,6 +747,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
+
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@@ -754,6 +755,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
+
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@@ -761,12 +763,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
+
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
+
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@@ -774,13 +778,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
+
Focusing on the right of a starter image stretched to fit the height of the
canvas.
-
+
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@@ -822,7 +827,7 @@ quit, or another picture is loaded or a new image is created. (In other words,
if you base a drawing on a 'template' image, it will always be affected by it.)
-Template Options
+ ### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@@ -963,7 +968,7 @@ layouts).
We'll use the QWERTY keyboard as an example:
-Layout overview file ("qwerty.layout")
+ ### Layout overview file ("qwerty.layout") ###
This is a text file that specifies the other files used to describe the layout
and key mappings.
@@ -981,7 +986,7 @@ seen in the example above.
The "keyboardlist" line describes which layouts to switch to, when the user
clicks the left and right buttons on the keyboard. (See below.)
-Keyboard layout file ("qwerty.h_layout")
+ ### Keyboard layout file ("qwerty.h_layout") ###
This describes how big the keyboard is (as a "width × height" grid), and lists
each key with its numeric keycode (see the "keymap" file, below), the width it
@@ -1045,7 +1050,7 @@ described below.
* 1 — next layout (per the layout file's "keyboardlist" setting)
* 2 — previous layout (per the layout file's "keyboardlist" setting)
-Keymap file ("us-intl-altgr-dead-keys.keymap")
+ ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@@ -1085,7 +1090,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Composemap file ("en_US.UTF-8_Compose")
+ ### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the
@@ -1096,7 +1101,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
-Keysym definitions file ("keysymdef.h")
+ ### Keysym definitions file ("keysymdef.h") ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"
diff --git a/docs/ja_JP.UTF-8/FAQ.txt b/docs/ja_JP.UTF-8/FAQ.txt
index c32a20a18..59864813b 100644
--- a/docs/ja_JP.UTF-8/FAQ.txt
+++ b/docs/ja_JP.UTF-8/FAQ.txt
@@ -21,15 +21,15 @@
+------------------------------+
-------------------------------------------------------------------------------
-Drawing-related
+ ### Drawing-related ###
-Fonts I added to Tux Paint only show squares
+→ Fonts I added to Tux Paint only show squares ←
The TrueType Font you're using might have the wrong encoding. If it's
'custom' encoded, for example, you can try running it through FontForge (
http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
(Email us if you need help with special fonts.)
-
-The Rubber Stamp tool is greyed out!
+
+→ The Rubber Stamp tool is greyed out! ←
This means that Tux Paint either couldn't find any stamp images, or was
asked not to load them.
@@ -55,8 +55,8 @@ The Rubber Stamp tool is greyed out!
configuration file.
-
-Stamp outlines are always rectangles
+
+→ Stamp outlines are always rectangles ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@@ -68,13 +68,13 @@ Stamp outlines are always rectangles
in the "tuxpaint.c" file in the "src" directory.
-
+
-------------------------------------------------------------------------------
-Interface Problems
+ ### Interface Problems ###
-Stamp thumbnails in the Stamp Selector look bad
+→ Stamp thumbnails in the Stamp Selector look bad ←
Tux Paint was probably compiled with the faster, lower quality thumbnail
code enabled. Run the command: "tuxpaint --verbose-version" from a command
@@ -89,24 +89,24 @@ Stamp thumbnails in the Stamp Selector look bad
in the "tuxpaint.c" file in the "src" directory.
-
-Pictures in the 'Open' dialog look bad
+
+→ Pictures in the 'Open' dialog look bad ←
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
Stamp Selector look bad", above.
-
-All of the text is in uppercase!
+
+→ All of the text is in uppercase! ←
The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override it with
"--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
yes" in a configuration file.
-
-Tux Paint is in a different language
+
+→ Tux Paint is in a different language ←
Make sure your locale setting is correct. See "Tux Paint won't switch to my
language", below.
-
-Tux Paint won't switch to my language
+
+→ Tux Paint won't switch to my language ←
+ Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your "/etc/
@@ -142,13 +142,13 @@ Tux Paint won't switch to my language
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-印刷
+ ### 印刷 ###
-Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
+→ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) ←
Tux Paint prints by creating a PostScript rendition of the picture and
sending it to an external command. By default, this command is the "lpr"
@@ -167,8 +167,8 @@ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
you will need to go back and alter it to accept PostScript.
-
-I get the message "You can't print yet!" when I go to print
+
+→ I get the message "You can't print yet!" when I go to print ←
The "print delay" option is on. You can only print once every X seconds.
@@ -190,8 +190,8 @@ I get the message "You can't print yet!" when I go to print
allow unlimited printing. (You won't have to wait between prints.)
-
-I simply can't print! The button is greyed out!
+
+→ I simply can't print! The button is greyed out! ←
The "no print" option is on.
@@ -212,41 +212,41 @@ I simply can't print! The button is greyed out!
checked.
-
+
-------------------------------------------------------------------------------
-保存
+ ### 保存 ###
-Where does Tux Paint save my drawings?
+→ Where does Tux Paint save my drawings? ←
Unless you asked Tux Paint to save into a specific location (using the
"savedir" option), Tux Paint saves into a standard location on your local
drive:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\ユーザー名\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g., "/Users/ユーザー名/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/ユーザー名/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
The images are stored as PNG bitmaps, which most modern programs should be
able to load (image editors, word processors, web browsers, etc.)
-
-Tux Paint always saves over my old picture
+
+→ Tux Paint always saves over my old picture ←
The "save over" option is enabled. (This disables the prompt that would
appear when you click 'Save.')
@@ -271,8 +271,8 @@ Tux Paint always saves over my old picture
Also, see "Tux Paint always saves a new picture!", below.
-
-Tux Paint always saves a new picture!
+
+→ Tux Paint always saves a new picture! ←
The "never save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@@ -297,13 +297,13 @@ Tux Paint always saves a new picture!
Also, see "Tux Paint always saves over my old picture!", above.
-
+
-------------------------------------------------------------------------------
-Audio Problems
+ ### Audio Problems ###
-There's no sound!
+→ There's no sound! ←
+ First, check the obvious:
o Are your speakers connected and turned on?
o Is the volume turned up on your speakers?
@@ -363,8 +363,8 @@ There's no sound!
headers are available!
-
-Tux Paint makes too much noise! Can I turn them off?
+
+→ Tux Paint makes too much noise! Can I turn them off? ←
Yes, there are a number of ways to disable sounds in Tux Paint:
@@ -380,9 +380,9 @@ Tux Paint makes too much noise! Can I turn them off?
o Alternatively, recompile Tux Paint with sound support disabled.
(See above, and the 'Install' documentation.
-
-The stereo panning of sound effects is bothersome; can sound effects be
- monophonic?
+
+→ The stereo panning of sound effects is bothersome; can sound effects be
+ monophonic? ←
Run Tux Paint with the "no stereo" option:
@@ -393,8 +393,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
"Video & Sound") is not checked.
-
-The sound effects sound strange
+
+→ The sound effects sound strange ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@@ -404,16 +404,17 @@ The sound effects sound strange
"tuxpaint --version" to verify), and so on.)
-
+
-------------------------------------------------------------------------------
-Fullscreen Mode Problems
+ ### Fullscreen Mode Problems ###
-When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
+→ When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns
+ black! ←
This is apparently a bug in the SDL library. Sorry.
-
-When I run Tux Paint full-screen, it has large borders around it
+
+→ When I run Tux Paint full-screen, it has large borders around it ←
Linux users - Your X-Window server is probably not set with the ability to
switch to the desired resolution: 800×600. (or whatever resolution you have
@@ -440,8 +441,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
-
-Tux Paint keeps running in Full Screen mode - I want it windowed!
+
+→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
The "fullscreen" option is set.
@@ -464,20 +465,21 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
is not checked.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [左矢印],
then back to Tux Paint using [Control] + [右矢印].
-
+
-------------------------------------------------------------------------------
-Other Problems
+ ### Other Problems ###
-Tux Paint won't run
+→ Tux Paint won't run ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -503,8 +505,8 @@ Tux Paint won't run
command-line, or "nolockfile=yes" to the configuration file.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -526,8 +528,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-I can't quit Tux Paint
+
+→ I can't quit Tux Paint ←
The "no quit" option is set. This disables the "Quit" button in Tux Paint's
toolbar (greying it out), and prevents Tux Paint from being exited via the
@@ -543,8 +545,8 @@ I can't quit Tux Paint
combination on your keyboard to quit Tux Paint.)
-
-I don't want "no quit" mode enabled!
+
+→ I don't want "no quit" mode enabled! ←
If you're running Tux Paint from a command-line, make sure you're not
giving it a "--noquit" option.
@@ -563,8 +565,8 @@ I don't want "no quit" mode enabled!
Key" (under "単純化") is not checked.
-
-Tux Paint keeps writing weird messages to the screen / to a text file
+
+→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@@ -578,8 +580,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
in the "tuxpaint.c" file in the "src" directory.
-
-Tux Paint is using options I didn't specify!
+
+→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@@ -656,11 +658,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Help / Contact
+ ### Help / Contact ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:
diff --git a/docs/ja_JP.UTF-8/INSTALL.txt b/docs/ja_JP.UTF-8/INSTALL.txt
index d0b7d36af..3005c529b 100644
--- a/docs/ja_JP.UTF-8/INSTALL.txt
+++ b/docs/ja_JP.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Requirements
-Simple DirectMedia Layer library (libSDL)
+ ### Simple DirectMedia Layer library (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Other Libraries
+## Other Libraries ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
-libPNG
+→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (Linux/Unix only)
+
+→ libpaper (Linux/Unix only) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@@ -92,8 +92,8 @@ libpaper (Linux/Unix only)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
-
-SVG graphics support
+
+→ SVG graphics support ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
- librsvg-2 & libCairo2 (newer libraries)
+ → librsvg-2 & libCairo2 (newer libraries) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o These also depend on the following:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Older SVG libraries
+
+ → Older SVG libraries ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o These also depend on the following:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Animated GIF Export feature
+
+→ Animated GIF Export feature ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@@ -133,8 +133,8 @@ Animated GIF Export feature
https://github.com/ImageOptim/libimagequant
-
-NetPBM Tools (optional) No longer used, by default
+
+→ NetPBM Tools (optional) No longer used, by default ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@@ -144,7 +144,7 @@ NetPBM Tools (optional) No longer used, by default
http://netpbm.sourceforge.net/
-
+
Compiling and Installation
@@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
2022年7月10日 Shin-ichi TOYAMA
-Compiling Set-Up
+## Compiling Set-Up ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@@ -207,7 +207,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@@ -264,7 +264,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -365,7 +365,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -393,7 +393,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Building the Tux Paint Windows Installer
+## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Running the Tux Paint Windows Installer
+## Running the Tux Paint Windows Installer ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
-Changing the Settings Using the Shortcut
+## Changing the Settings Using the Shortcut ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@@ -460,7 +460,7 @@ pushed the "Apply" button!).
When you have finished, click "OK."
-If Something Goes Wrong
+## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -474,9 +474,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Compiling:
+## Compiling: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -487,7 +487,8 @@ shell prompt (e.g., "$"):
$ make
-Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+## Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
+##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@@ -495,7 +496,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
-Disabling Sound at Compile-time
+## Disabling Sound at Compile-time ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@@ -503,12 +504,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
-Other options
+## Other options ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
-If you get errors
+## If you get errors ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@@ -516,7 +517,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
-Installng
+## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@@ -542,7 +543,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Changing Where Things Go
+# Changing Where Things Go #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@@ -551,48 +552,48 @@ default, set to "/usr/local".
Other variables are:
-BIN_PREFIX
+→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
2022年6月 5日 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Prerequisites
+## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -628,7 +629,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -640,7 +641,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -654,7 +655,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-How to Build
+## How to Build ##
Simply, run:
@@ -668,7 +669,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Known Issues
+## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -685,7 +686,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Old Versions of macOS
+## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -725,7 +726,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Recompiling MacPorts
+## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -749,7 +750,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Building a Universal Binary
+## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -763,7 +764,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
2023年3月29日 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -772,7 +773,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Prerequisites
+## Prerequisites ##
You will need recent versions of:
@@ -797,7 +798,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Building
+## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -826,36 +827,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
2023年5月 7日 Luc Schrijvers (Edited by Bill Kendrick)
-Prerequisites
+## Prerequisites ##
Install the required develop packages in Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Building
+## Building ##
make PREFIX=/boot/home/config/non-packaged
-Tux Paint Stamps
+## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -868,9 +870,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
-Windows
+ ### Windows ###
-Using the Uninstaller
+## Using the Uninstaller ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@@ -879,19 +881,19 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
When it has finished, click on the close button.
-Using the Control Panel
+## Using the Control Panel ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
"/Library/Application Support/TuxPaint/" (all users) and
"/Users/ユーザー名/Library/Application Support/TuxPaint/" (individual users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/ja_JP.UTF-8/MAGIC-API.txt b/docs/ja_JP.UTF-8/MAGIC-API.txt
index 6a2f9781f..028f6a9b0 100644
--- a/docs/ja_JP.UTF-8/MAGIC-API.txt
+++ b/docs/ja_JP.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/ja_JP.UTF-8/OPTIONS.txt b/docs/ja_JP.UTF-8/OPTIONS.txt
index 3af90eed6..96fad392d 100644
--- a/docs/ja_JP.UTF-8/OPTIONS.txt
+++ b/docs/ja_JP.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
バージョン 0.9.34
- 各種設定について
+ ### 各種設定について ###
Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
https://tuxpaint.org/
@@ -46,11 +46,11 @@ Tux Paint の動作をカスタマイズするには、グラフィカルな操
設定ファイルは、有効にしたいオプションを記述した、シンプルなテキストファイルで
す。
-Linux 及び Unix のユーザー
+ ### Linux 及び Unix のユーザー ###
/home/ユーザー名/.tuxpaintrc
-システム全体の設定ファイル
+## システム全体の設定ファイル ##
ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー
ザーに適用される設定ファイルが読み込まれます。(標準では、全ての変更が無効にさ
@@ -58,11 +58,11 @@ Linux 及び Unix のユーザー
/etc/tuxpaint/tuxpaint.conf
-macOS のユーザー
+ ### macOS のユーザー ###
/Users/ユーザー名/Library/Application Support/TuxPaint/tuxpaint.cfg
-システム全体の設定ファイル
+## システム全体の設定ファイル ##
ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー
ザーに適用される設定ファイルが読み込まれます。(標準では、全ての変更が無効にさ
@@ -70,7 +70,7 @@ macOS のユーザー
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Windows のユーザー
+ ### Windows のユーザー ###
C:\Users\ユーザー名\AppData\Roaming\TuxPaint\tuxpaint.cfg
@@ -78,7 +78,7 @@ C:\Users\ユーザー名\AppData\Roaming\TuxPaint\tuxpaint.cfg
保存するよう注意して下さい。また、ファイル名に ".txt" という拡張子をつけないよ
うにします。
-システム全体の設定ファイル
+## システム全体の設定ファイル ##
ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー
ザーに適用される設定ファイルが読み込まれます。(標準では、全ての変更が無効にさ
@@ -86,7 +86,7 @@ C:\Users\ユーザー名\AppData\Roaming\TuxPaint\tuxpaint.cfg
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku のユーザー
+ ### Haiku のユーザー ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -100,11 +100,11 @@ Haiku のユーザー
プションによる設定が優先されます。以下のコマンドラインオプション"の項をごらん下
さい)
-画面・音声
+ ### 画面・音声 ###
-画面
+## 画面 ##
-fullscreen=yes
+→ fullscreen=yes ←
プログラムを、ウィンドウ内ではなく、フルスクリーンモードで起動します。
@@ -113,15 +113,15 @@ fullscreen=yes
の設定も、コマンドラインオプションの "--windowed" で変更できます。
-
-fullscreen=native
+
+→ fullscreen=native ←
プログラムをフルスクリーンモードで起動します。その際、画面の解像度をオペ
レーティングシステムの設定から推定します。
-
-windowsize=SIZE
+
+→ windowsize=SIZE ←
ウィンドウモードの場合、"SIZE" で指定するウィンドウサイズで、フルスクリーン
モードの場合、"SIZE" で指定する解像度でプログラムを起動します。(標準では
@@ -144,8 +144,8 @@ windowsize=SIZE
ます。
-
-orient=portrait
+
+→ orient=portrait ←
ウィンドウの幅と高さの設定を入れ替えます。これは、タブレットパソコンのよう
な縦型のディスプレイでウィンドウを回転させる際に便利なオプションです。
@@ -156,15 +156,15 @@ orient=portrait
す。
-
-native=yes
+
+→ native=yes ←
Tux Paint をフルスクリーンモードで起動する際、"windowsize" オプションの設定
を無視して、オペレーティングシステムが設定する画面解像度に従います。
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
標準では、Tux Paint の起動中はスクリーンセーバーが起動しない設定になってい
ますが、"allowscreensaver" オプションを指定すると、スクリーンセーバーが有効
@@ -177,11 +177,11 @@ allowscreensaver=yes
"--disablescreensaver" で変更できます。
+
+## 音声 ##
-音声
-
-nosound=yes
+→ nosound=yes ←
効果音を無効にします。(注: このオプションを設定すると、[Alt] + [S] を押し
ても、効果音を有効化することはできません
@@ -192,8 +192,8 @@ nosound=yes
す。
-
-nostereo=yes
+
+→ nostereo=yes ←
ステレオの効果音を無効にする。(片耳イヤホンや1台のスピーカーで使用する場
合に役に立ちます)
@@ -204,11 +204,11 @@ nostereo=yes
きます。
+
+## インターフェースサイズ ##
-インターフェースサイズ
-
-buttonsize=SIZE
+→ buttonsize=SIZE ←
Tux Paint のユーザーインターフェースの各種ボタンのサイズを標準の "48" から
変更します。非常に高解像度のディスプレイや、視線入力といった分解能の低い操
@@ -227,8 +227,8 @@ buttonsize=SIZE
す。(その旨がstderrに出力されます)
-
-colorsrows=ROWS
+
+→ colorsrows=ROWS ←
カラーパレットのボタンを何列表示するかを指定します。色数の多いカラーパレッ
ト(上記の "colorfile" を参照)を使う場合や、視線入力などの分解能の低い操作
@@ -236,13 +236,13 @@ colorsrows=ROWS
での値を指定します。
+
+ ### マウス・キーボード ###
-マウス・キーボード
+## マウスカーソル ##
-マウスカーソル
-
-nofancycursors=yes
+→ nofancycursors=yes ←
Tux Paint 独自のマウスポインタを無効にし、システム標準のマウスポインタを使
用するようにします。
@@ -256,8 +256,8 @@ nofancycursors=yes
"--fancycursors" で変更できます。
-
-hidecursor=yes
+
+→ hidecursor=yes ←
マウスカーソルを表示しないようにします。
@@ -270,11 +270,11 @@ hidecursor=yes
で変更できます。
+
+## キーボード ##
-キーボード
-
-noshortcuts=yes
+→ noshortcuts=yes ←
キーボードショートカット(保存: [Ctrl]-[S]、新規作成: [Ctrl]-[N] など)を無
効にします。
@@ -288,11 +288,11 @@ noshortcuts=yes
で変更できます。
+
+## マウス ##
-マウス
-
-grab=yes
+→ grab=yes ←
Tux Paint がマウスとキーボードを「独占」します。マウスカーソルが Tux Paint
のウィンドウ内に限定され、ほとんどすべてのキーボード入力が直接 Tux Paint に
@@ -309,8 +309,8 @@ grab=yes
きます。
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
マウスでのホイールによる操作が無効になります。(通常、ホイールは右のセレク
ターメニューをスクロールします)。
@@ -321,8 +321,8 @@ nowheelmouse=yes
"--wheelmouse" で変更できます。
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Tux Paint 0.9.15 以前では、マウスの中ボタンと右ボタンでもクリックが可能でし
たが、バージョン0.9.15からは、子供たちが間違ったボタン押さないように、マウ
@@ -337,13 +337,13 @@ nobuttondistinction=yes
の "--buttondistinction" で変更できます。
+
+ ### 単純化 ###
-単純化
+## 操作の単純化 ##
-操作の単純化
-
-simpleshapes=yes
+→ simpleshapes=yes ←
「ずけい」ツールで、形を決めたあとに回転させるステップを省略します。クリッ
クして、ドラッグして、ボタンを離すだけで、図形を描くことができます。
@@ -354,8 +354,8 @@ simpleshapes=yes
"--complexshapes" で変更できます。
-
-nooutlines=yes
+
+→ nooutlines=yes ←
このモードでは、「せん」ツール、「かたち」ツール、「はんこ」ツールそしてけ
しゴムを使うときに、アウトラインをシンプルな線で表示します。
@@ -369,8 +369,8 @@ nooutlines=yes
変更できます。
-
-uppercase=yes
+
+→ uppercase=yes ←
すべてのテキストが大文字で表記されます(例: 「Brush」は「BRUSH」)。まだ大
文字しか習っていない子供たちにとって役に立つオプションです。
@@ -381,11 +381,11 @@ uppercase=yes
変更できます。
+
+## スタンプの初期サイズ ##
-スタンプの初期サイズ
-
-stampsize=SIZE
+→ stampsize=SIZE ←
すべてのスタンプの初期の大きさを 0(最小)から 10(最大)の間で設定します。
SIZE の値はスタンプ自体の大きさと Tux Paint のキャンバスサイズによって決ま
@@ -395,11 +395,11 @@ stampsize=SIZE
定します。(これが標準の動作です)
+
+## 機能制限 ##
-機能制限
-
-noquit=yes
+→ noquit=yes ←
画面の "やめる" ボタンや [Escape] キーによるプログラム終了を無効にする。
@@ -415,8 +415,8 @@ noquit=yes
す。
-
-nostamps=yes
+
+→ nostamps=yes ←
「はんこ」の画像を読み込まず、「はんこ」ツールを無効にします。
@@ -428,8 +428,8 @@ nostamps=yes
きます。
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
「はんこ」ツールの画像には、上下または左右に反転できたり、大きさを変更した
りできるものがあります。このオプションを設定すると、このような操作を無効に
@@ -441,8 +441,8 @@ nostampcontrols=yes
"--stampcontrols" で変更できます。
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
はんこを回転させるステップを省略し、1回のクリックで通常の向きにはんこを配
置します。
@@ -455,8 +455,8 @@ nostamprotation=yes
"--stamprotation" で変更できます。
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
「まほう」ツールの中には、「ふで」ツールのように画像の一部分だけに効果を及
ぼすか、キャンバス全体に効果を及ぼすかを選択できるものがあります。このオプ
@@ -470,8 +470,8 @@ nomagiccontrols=yes
"--magiccontrols" で変更できます。
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
「まほう」ツールの中には、描画のサイズや効果が及ぶ幅の大きさを変更できるも
のがあります。このオプションを設定するとサイズの変更を無効にして、ツールご
@@ -484,8 +484,8 @@ nomagicsizes=yes
"--magicsizes" で変更できます。
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
デフォルトでは、タックスペイントの「まほう」ツールは、似たようなツールのグ
ループにまとめられています(例えば、色、彩度、暗転/明転ツールはすべて一まと
@@ -501,8 +501,8 @@ ungroupmagictools=yes
"--groupmagictools" で変更できます。
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
「かたち」ツールでの2つの動作モード-マウスをクリックした箇所を中心として
図形を拡大するか、マウスをクリックした箇所をコーナーとして図形を拡大するか
@@ -514,8 +514,8 @@ noshapecontrols=yes
"--shapecontrols" で変更できます。
-
-nolabel=yes
+
+→ nolabel=yes ←
「ラベル」ツールを無効にします。
@@ -525,8 +525,8 @@ nolabel=yes
す。
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
「ふで」ツールとLines「せん」ツールで、描画間隔の調整を無効にします。標準の
描画間隔が用いられます。
@@ -540,8 +540,8 @@ nobrushspacing=yes
"--brushspacing" で変更できます。
-
-complexity=COMPLEXITY
+
+→ complexity=COMPLEXITY ←
タックスペイントの操作の複雑さ(熟達度合い)のレベルを設定します。これによ
り、いくつかの「まほう」ツールが無効になったり、異なる動作をしたりします。
@@ -550,17 +550,17 @@ complexity=COMPLEXITY
COMPLEXITY は以下の3とおりから選択できます。
- advanced (the default)
+ → advanced (the default) ←
「上級者」 — Tux Paint に精通していて、複雑な操作が可能なユーザー向け。
-
- beginner
+
+ → beginner ←
「中級者」 — ある程度 Tux Paint に慣れているが、複雑なツールにとまどっ
たり、フラストレーションを感じるユーザー向け。
-
- novice
+
+ → novice ←
「初心者」 — 初めて Tux Paint を使うユーザーや、コンピューターの経験が
浅いユーザー、または、特殊な操作が必要なユーザー向け
-
+
📜 注: 難易度のオプションは、Tux Paint バージョン 0.9.32 で導入されました。
詳しくは個々の「まほう」ツールのドキュメントを参照して下さい。
@@ -571,8 +571,8 @@ complexity=COMPLEXITY
きます。
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
「ひらく」ダイアログで、保存された作品を用いて新しいテンプレート画像を作成
する機能を無効にします。
@@ -585,8 +585,8 @@ notemplateexport=yes
"--templateexport" で変更できます。
-
-noerase=yes
+
+→ noerase=yes ←
「ひらく」ダイアログの「けす」ボタンを使って保存した作品を削除したり、「さ
いしょから」ダイアログの「けす」ボタンを使って自作のテンプレート画像を削除
@@ -601,13 +601,13 @@ noerase=yes
す。
+
+ ### 言語関連 ###
-言語関連
+## 言語 ##
-言語
-
-lang=LANGUAGE
+→ lang=LANGUAGE ←
サポートされている中から言語を指定して Tux Paint を起動します。現時点で
LANGUAGEに指定できる言語は以下のとおりです:
@@ -869,8 +869,8 @@ lang=LANGUAGE
+-----------------------------------------------------------------+
-
---locale LOCALE
+
+→ --locale LOCALE ←
Tux Paint で使用する言語を指定します。使用する言語ごとの言語コードの設定
(例えば、ドイツ語では "de_DE")については、以下の "使用する言語を変更する"
@@ -880,8 +880,8 @@ lang=LANGUAGE
先されるので、このオプションを設定するは必要ありません。)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
反転可能なスタンプは、はじめから反転されるようにします。
@@ -894,11 +894,11 @@ mirrorstamps=yes
"--dontmirrorstamps" で変更できます。
+
+## フォント ##
-フォント
-
-sysfonts=yes
+→ sysfonts=yes ←
もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux
Paint はパッケージに付属するフォントだけを使用します。
@@ -909,8 +909,8 @@ sysfonts=yes
で変更できます。
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
バージョン0.9.21以前では、Tux Paintは、特定の言語のみに固有のもの(例えば、
ラテン文字を持たないチベット語のフォントなど)も含めて、fonts ディレクトリ
@@ -926,8 +926,8 @@ alllocalefonts=yes
"--currentlocalefont" で変更できます。
-
-uifont=FONT NAME
+
+→ uifont=FONT NAME ←
もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux
Paint はパッケージに付属するフォントだけを使用します。
@@ -935,19 +935,19 @@ uifont=FONT NAME
"default" を指定すると、規定のフォントが使用されます。(標準の動作)
+
+ ### 印刷 ###
-印刷
+## 印刷の制御 ##
-印刷の制御
-
-noprint=yes
+→ noprint=yes ←
印刷を無効にします。
-
-printdelay=SECONDS
+
+→ printdelay=SECONDS ←
SECONDS で設定した秒数ごとに1回だけしか印刷できなくなります。
@@ -956,11 +956,11 @@ printdelay=SECONDS
の設定も、コマンドラインオプションの "--printdelay=0" で変更できます。
+
+## 印刷ダイアログの表示 ##
-印刷ダイアログの表示
-
-altprint=always
+→ altprint=always ←
"いんさつ" ボタンをクリックすると、常に印刷ダイアログを表示します(Linux と
Unix では、"altprintcommand" で設定したプログラムが起動します)。[Alt] キー
@@ -968,27 +968,27 @@ altprint=always
キーを押す必要がないということです。
-
-altprint=never
+
+→ altprint=never ←
"いんさつ" ボタンを押したときの [Alt] キーの効果を無効にして、印刷ダイアロ
グが表示されないようにします(Linux と Unix では、"altprintcommand" で設定
したコマンドが起動されなくなります)。
-
-altprint=mod
+
+→ altprint=mod ←
印刷時の標準の動作です。[Alt] キーを押しながら "いんさつ" ボタンをクリック
すると印刷ダイアログが表示され、[Alt] キーを押さずに "いんさつ" ボタンをク
リックすると、ダイアログを表示せずに印刷します。
+
+## 印刷設定の保存 ##
-印刷設定の保存
-
- printcfg=yes
+ → printcfg=yes ←
(Windows と macOS のみ)
@@ -1006,11 +1006,11 @@ altprint=mod
"--noprintcfg" で変更できます。
+
+ ## 印刷コマンド ##
- 印刷コマンド
-
- printcommand=COMMAND
+ → printcommand=COMMAND ←
(Linux 及び Unix の場合のみ)
@@ -1027,8 +1027,8 @@ altprint=mod
た場合は、この設定を変更する必要があります。
-
- altprintcommand=COMMAND
+
+ → altprintcommand=COMMAND ←
(Linux 及び Unix の場合のみ)
@@ -1042,11 +1042,11 @@ altprint=mod
kprinter
+
+ ## 用紙サイズ ##
- 用紙サイズ
-
- papersize=PAPERSIZE
+ → papersize=PAPERSIZE ←
(Windows, macOS, BeOS, Haiku を除く、内蔵 PostScript 出力エンジンを使
用するプラットフォーム向け)
@@ -1062,39 +1062,39 @@ altprint=mod
esheet.
+
+ ### 保存 ###
- 保存
+ ## 上書き保存 ##
- 上書き保存
-
- saveover=yes
+ → saveover=yes ←
以前の絵を編集して保存するときに、"いまかいたえとまえのえをいれかえる?
" と確認を求めないようにします。この設定では、前の絵は常に上書きされま
す。
-
- saveover=new
+
+ → saveover=new ←
上記と同様に保存の確認を求めないようにしますが、この設定では、前の絵を
上書きせずに、常に新しいファイルを作成して保存します。
-
- saveover=ask
+
+ → saveover=ask ←
(絵を保存するときの標準の動作なので、この設定は冗長なものとなります)
以前の絵を編集して保存するときに、以前の絵を上書きするかどうかを尋ねら
れます。
+
+ ## 起動時の設定 ##
- 起動時の設定
-
- startblank=yes
+ → startblank=yes ←
Tux Paint を起動する際、前回最後に開いていた絵を読み込む代わりに、毎
回、空のキャンバスで開始します。
@@ -1105,8 +1105,8 @@ altprint=mod
"--startlast" で変更できます。
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
「さいしょから」でキャンバスを選択する際、単色のキャンバスが末尾に、ス
ターター画像やテンプレートが先頭になるよう、表示順序を変更します。
@@ -1117,29 +1117,29 @@ altprint=mod
ションの "--newcolorsfirst" で変更できます。
+
+ ## 保存・書き出し先のディレクトリ ##
- 保存・書き出し先のディレクトリ
-
- savedir=DIRECTORY
+ → savedir=DIRECTORY ←
Tux Paint が、作品を保存する "saved" ディレクトリの場所を変更します。
特に設定していなければ、標準のディレクトリは次の場所にあります:
- Linux / Unix
+ → Linux / Unix ←
各ユーザーのホームディレクトリ以下の隠しディレクトリ:
/home/ユーザー名/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\ユーザー名\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/ユーザー名/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 注: Windowsのドライブ(例: "H:\")を指定する際は、サブディレクトリも
指定する必要があります。
@@ -1153,8 +1153,8 @@ altprint=mod
例: savedir=Z:\tuxpaint\
-
- exportdir=DIRECTORY
+
+ → exportdir=DIRECTORY ←
「かきだす」によって、作品を画像にエクスポートして他で利用する場合や、
アニメーションGIFによるスライドショーデータなど、データの出力先のディレ
@@ -1193,11 +1193,11 @@ altprint=mod
例: exportdir=/home/penguin/TuxPaintExports
+
+ ## 保存関連の追加オプション ##
- 保存関連の追加オプション
-
- nosave=yes
+ → nosave=yes ←
絵の保存ができないようにします("セーブ" ボタンも無効になります)。一時
的なお遊びに使う場合や、テスト環境で使えるオプションです。
@@ -1208,8 +1208,8 @@ altprint=mod
変更できます。
-
- autosave=yes
+
+ → autosave=yes ←
プログラムを終了するときに、絵を保存するかどうか尋ねずに、自動的に保存
します。
@@ -1220,8 +1220,8 @@ altprint=mod
"--noautosave" で変更できます。
-
- reversesort=yes
+
+ → reversesort=yes ←
「ひらく」と「スライド」のダイアログで、先頭から新しい順に、作品を表示
します。
@@ -1232,13 +1232,13 @@ altprint=mod
の "--noreversesort" で変更できます。
+
+ ### データ ###
- データ
+ ## ロックファイル ##
- ロックファイル
-
- nolockfile=yes
+ → nolockfile=yes ←
標準では、Tux Paint は「ロックファイル」と呼ばれるものを使用して、30秒
間に1回以上起動できないようになっています。これは、シングルクリックのラ
@@ -1258,11 +1258,11 @@ altprint=mod
"--lockfile" で変更できます。
+
+ ## データ・ディレクトリ ##
- データ・ディレクトリ
-
- datadir=DIRECTORY
+ → datadir=DIRECTORY ←
個人用データファイル(ペイントブラシ、スタンプ、スターター、テンプレー
ト、個人用のフォント)を検索する場所を変更します。
@@ -1273,15 +1273,15 @@ altprint=mod
特に設定していなければ、標準のディレクトリは次の場所にあります:
- Linux / Unix
+ → Linux / Unix ←
/home/ユーザー名/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\ユーザー名\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/ユーザー名/Library/Application Support/TuxPaint/
-
+
📜 注: バージョン 0.9.18 以前では、個人用データの検索先として "savedir"
の指定と同じディレクトリを使用していましたが、0.9.18 以降では個別に設定
@@ -1293,11 +1293,11 @@ altprint=mod
例: datadir=/home/johnny/tuxpaint-data/
+
+ ## カラーパレットファイル ##
- カラーパレットファイル
-
- colorfile=ファイル名
+ → colorfile=ファイル名 ←
お好みのカラーパレットを記述した簡単なテキストファイルを作成して、その
ファイル名を "colorfile" オプションで指定すれば、標準のカラーパレットを
@@ -1323,13 +1323,13 @@ altprint=mod
ため、"#FFF" は "#F0F0F0" ではなく "#FFFFFF" を意味します。
+
+ ### 操作方法 ###
- 操作方法
+ ## マウス ##
- マウス
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
例えば「せん」ツールなどでは、マウスをクリックしてドラッグした後にマウ
スボタンを放すというのが標準の操作ですが、このモードを設定すると、マウ
@@ -1337,11 +1337,11 @@ altprint=mod
操作になります。
+
+ ## キーボード ##
- キーボード
-
- keyboard=yes
+ → keyboard=yes ←
キーボードの矢印キーによるマウスポインターの操作が行えるようにします
(マウスが使えない場合や、マウス操作が難しいユーザー向けの機能です)
@@ -1381,17 +1381,17 @@ altprint=mod
"--mouse" で変更できます。
+
+ ## 画面キーボード ##
- 画面キーボード
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
「もじ」ツールと「ラベル」ツールで、画面キーボードを表示します。
-
- onscreen-keyboard-layout=レイアウト名
+
+ → onscreen-keyboard-layout=レイアウト名 ←
もじツールとラベルツールで使用する画面キーボードの初期レイアウトを指定
します。
@@ -1399,8 +1399,8 @@ altprint=mod
なします。
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
画面キーボードの変更をできないようにします。小さな子供向けにシンプルに
したい場合に設定します。
@@ -1413,192 +1413,192 @@ altprint=mod
"--onscreen-keyboard-disable-change=no" で変更できます。
+
+ ### ジョイスティック ###
- ジョイスティック
+ ## デバイスの設定 ##
- デバイスの設定
-
- joystick-dev=N
+ → joystick-dev=N ←
何番目のジョイスティックデバイスを使うかを設定します。標準では 0 (最初
のジョイスティック)
-
- joystick-slowness=SPEED
+
+ → joystick-slowness=SPEED ←
ジョイスティックの感度を SPEED の値で設定します。0 から 500 までの値が
設定できます。標準の値は 15 です。
-
- joystick-threshold=THRESHOLD
+
+ → joystick-threshold=THRESHOLD ←
ジョイスティックでポインターを動かし始めるためのしきい値を THRESHOLD の
値で設定します。0 から 32766 までの値が設定できます。標準の値は 3200 で
す。
-
- joystick-maxsteps=STEPS
+
+ → joystick-maxsteps=STEPS ←
ポインターの移動速度の上限を STEPS にピクセル単位で設定します。1 から 7
までの値が設定可能で、標準の値は 7 です。
+
+ ## ハットスイッチ ##
- ハットスイッチ
-
- joystick-hat-slowness=SPEED
+ → joystick-hat-slowness=SPEED ←
ハットスイッチの感度を設定します。設定可能な値は 0 から 500 で、標準の
値は 15 です。
-
- joystick-hat-timeout=MILLISECONDS
+
+ → joystick-hat-timeout=MILLISECONDS ←
ジョイスティックのハットスイッチを押し続けたときに、ポインターが連続し
て動き始めるまでの時間を MILLISECONDS にミリ秒単位で設定します。0 から
3000 までの値が設定可能で、標準の設定は 1000 です。
+
+ ## ボタンの無効化 ##
- ボタンの無効化
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
無効にするジョイスティックのボタンの番号を指定します。何も指定しない場
合、上記の "joystick-btn-" オプションで機能が設定されたボタン以外は、マ
ウスの左ボタンと同じ動作になります。
+
+## ボタンショートカット ##
-ボタンショートカット
-
- joystick-btn-escape=BUTTON NUMBER
+ → joystick-btn-escape=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "ESC" キーの機能を
割り当てます。(ダイアログの "もどる" や "やめる" で使います)
-
- joystick-btn-brush=BUTTON NUMBER
+
+ → joystick-btn-brush=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「ふで」ツール" へ
のショートカットを割り当てます。
-
- joystick-btn-stamp=BUTTON NUMBER
+
+ → joystick-btn-stamp=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「はんこ」ツール"
へのショートカットを割り当てます。
-
- joystick-btn-lines=BUTTON NUMBER
+
+ → joystick-btn-lines=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「せん」ツール" へ
のショートカットを割り当てます。
-
- joystick-btn-shapes=BUTTON NUMBER
+
+ → joystick-btn-shapes=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「かたち」ツール"
へのショートカットを割り当てます。
-
- joystick-btn-text=BUTTON NUMBER
+
+ → joystick-btn-text=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「もじ」ツール" へ
のショートカットを割り当てます。
-
- joystick-btn-label=BUTTON NUMBER
+
+ → joystick-btn-label=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「ラベル」ツール"
へのショートカットを割り当てます。
-
- joystick-btn-fill=BUTTON NUMBER
+
+ → joystick-btn-fill=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「ぬる」ツール" へ
のショートカットを割り当てます。
-
- joystick-btn-magic=BUTTON NUMBER
+
+ → joystick-btn-magic=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「まほう」ツール"
へのショートカットを割り当てます。
-
- joystick-btn-undo=BUTTON NUMBER
+
+ → joystick-btn-undo=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「とりけし」" への
ショートカットを割り当てます。
-
- joystick-btn-redo=BUTTON NUMBER
+
+ → joystick-btn-redo=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「やりなおし」" を
選択するショートカットを割り当てます。
-
- joystick-btn-eraser=BUTTON NUMBER
+
+ → joystick-btn-eraser=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「けしごむ」" を選
択するショートカットを割り当てます。
-
- joystick-btn-new=BUTTON NUMBER
+
+ → joystick-btn-new=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに、「さいしょから」ダ
イアログへのショートカットを割り当てます。
-
- joystick-btn-open=BUTTON NUMBER
+
+ → joystick-btn-open=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに、「ひらく」ダイアロ
グへのショートカットを割り当てます。
-
- joystick-btn-save=BUTTON NUMBER
+
+ → joystick-btn-save=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「ほぞん」" への
ショートカットを割り当てます。
-
- joystick-btn-pgsetup=BUTTON NUMBER
+
+ → joystick-btn-pgsetup=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "印刷設定ダイアログ
" へのショートカットを割り当てます。
-
- joystick-btn-print=BUTTON NUMBER
+
+ → joystick-btn-print=BUTTON NUMBER ←
ジョイスティックの BUTTON NUMBER で設定したボタンに "「いんさつ」" への
ショートカットを割り当てます。
-
+
システム全体の設定を上書きする
@@ -1623,7 +1623,7 @@ altprint=mod
各種オプションは、Tux Paint を起動する際のコマンドラインで指定することもで
きます。
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--WIDTHxHEIGHT
--orient=portrait
@@ -1705,13 +1705,14 @@ altprint=mod
--reversesort
--lang LANGUAGE
--colorfile FILE
+ ←
以上のオプションは、上記で説明した設定ファイルでの各種オプションと関連
しています。
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1752,14 +1753,15 @@ altprint=mod
--save
--noautosave
--noreversesort
+ ←
以上のオプションは、設定ファイルでの設定を上書きするために用いられま
す。(オプションが設定ファイルで指定されていない場合、設定を上書きしな
いというオプションが必要です)
-
- --nosysconfig
+
+ → --nosysconfig ←
これにより、システム全体の設定ファイル(例: Linuxでは
"/etc/tuxpaint/tuxpaint.conf")が読み込まれなくなります。
@@ -1769,53 +1771,53 @@ altprint=mod
を読み込みます。
+
-
- 情報を表示するためのコマンドラインオプション
+ ### 情報を表示するためのコマンドラインオプション ###
以下の各オプションは、Tux Paint を起動せず、情報をテキスト画面に表示して終
了します。
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
プログラムのバージョンとリリース日を表示します。"--verbose-version" オ
プションでは、コンパイル時のオプションも追加で表示します。(ドキュメン
ト "Tux Paint のインストール" および "よくある質問"もごらんください。)
-
- --copying
+
+ → --copying ←
Tux Paint のライセンスについての情報を表示します。
-
- --usage
+
+ → --usage ←
利用可能なコマンドラインオプションの一覧を表示します。
-
- --help
+
+ → --help ←
Tux Paint の使い方についての簡単な説明を表示します。
-
- --lang help
+
+ → --lang help ←
Tux Paint で利用可能な言語の一覧を表示します。
-
- --joystick-dev list
+
+ → --joystick-dev list ←
接続されているジョイスティックについて、Tux Paint で利用可能なものの一
覧を表示します。
-
+
使用する言語の選択
@@ -1829,7 +1831,7 @@ altprint=mod
"--lang help" オプションを用いれば、利用可能な言語の一覧が表示されます。
- 利用可能な言語
+ ### 利用可能な言語 ###
+-------------------------------------------------------------------------+
| 言語コード | 言語名 | 言語名 | 入力切り替え |
@@ -2122,7 +2124,7 @@ altprint=mod
できます。もじツールが有効になっているときに、上の表に示されたキーの組み合
わせを使えば、利用可能な入力方式を順に切り替えることができます。
- 環境で使用する言語の設定
+ ### 環境で使用する言語の設定 ###
システムの言語を変更すると環境に大きな影響があります。
@@ -2132,7 +2134,7 @@ altprint=mod
言語環境を設定するやり方は以下のとおりです:
- Linux または Unix のユーザー
+ ## Linux または Unix のユーザー ##
まず最初に、使用したい言語が有効になるように "/etc/locale.gen" ファイルを確
認、編集した後、管理者権限で "locale-gen" コマンドを実行します。
@@ -2159,7 +2161,7 @@ altprint=mod
setenv LANG es_ES ; \
tuxpaint
- Windows のユーザー
+ ## Windows のユーザー ##
何もしなくても、利用している言語環境に応じて適切な設定が用いられますので、
以下は、他の言語で利用したい場合のための説明になります。
@@ -2184,7 +2186,7 @@ altprint=mod
+ "環境変数(N)..." ボタンをクリック。
+ 環境変数 "LANG" の値を編集。(変数が設定されていなければ新たに作成)
- 言語固有のフォント
+ ### 言語固有のフォント ###
いくつかの言語では、専用のフォントが必要になります。TrueType(TTF)形式の
フォントファイルは、サイズが非常に大きいので、Tux Paint のダウンロードファ
diff --git a/docs/ja_JP.UTF-8/PNG.txt b/docs/ja_JP.UTF-8/PNG.txt
index b7ece4db1..cc0993e36 100644
--- a/docs/ja_JP.UTF-8/PNG.txt
+++ b/docs/ja_JP.UTF-8/PNG.txt
@@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
-How To Make PNGs
+ ### How To Make PNGs ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
-GIMP & Krita
+→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
+
+→ Command-line Tools ←
-Command-line Tools
-
- NetPBM
+ → NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@@ -58,8 +58,8 @@ Command-line Tools
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@@ -68,11 +68,11 @@ Command-line Tools
or to learn more, visit https://jpegclub.org/.
+
-
-
-Proprietary Software for Windows
+
+→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -80,13 +80,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Macintosh Users
+
+→ Macintosh Users ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/ja_JP.UTF-8/README.txt b/docs/ja_JP.UTF-8/README.txt
index 97e42866a..f6821fafb 100644
--- a/docs/ja_JP.UTF-8/README.txt
+++ b/docs/ja_JP.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
バージョン 0.9.34
- 子供向けのシンプルなお絵かきプログラム
+ ## 子供向けのシンプルなお絵かきプログラム ##
Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
https://tuxpaint.org/
- 2024年10月12日
+ 2024年10月14日
+--------------------------------------------------+
| 目次 |
@@ -44,49 +44,49 @@
I. Tux Paint について
-A. "Tux Paint" とは?
+ ### A. "Tux Paint" とは? ###
Tux Paint は、3歳以上の小さな子供向けにデザインされたフリーのお絵かきソフトで
す。シンプルで使いやすい操作方法と楽しい効果音を備え、マスコットキャラクターが
子供たちの案内役を務めます。空っぽのキャンバスと様々な描画ツールが、子供たちの
創造力をかき立てます。
-B. 特長
+ ### B. 特長 ###
-簡単に、そして楽しく
+→ 簡単に、そして楽しく ←
Tux Paint は、一般向けの描画ツールではなく、小さな子供のためのシンプルなお
絵かきソフトとなることを目指して、楽しく容易に使えるように作られています。
効果音とマスコットキャラクターが、プログラムの操作をわかりやすく教えてくれ
るとともに、ユーザーを楽しませてくれます。また、大きくて見やすいイラスト調
のマウスポインターを採用しています。
-
-拡張性
+
+→ 拡張性 ←
Tux Paint は、機能を拡張することができます。「ふで」や「はんこ」は、追加や
削除が可能です。例えば、授業では、様々な生き物の画像を追加しておいて、生徒
に生態系を描かせるといったことができます。それぞれの「はんこ」には、選択時
に流れる音声、表示される説明文を設定できます。
-
-移植性
+
+→ 移植性 ←
Tux Paint は、Windows, Macintosh, Linux など、様々なプラットフォームに移植
されており、どのプラットフォームでも見た目や使い方は変わりません。Tux Paint
は、Pentium 133のような旧式のシステムでもうまく動作し、さらに遅いシステムで
も動作するように構築することもできます。
-
-簡単な操作
+
+→ 簡単な操作 ←
ユーザーは、コンピューターの複雑な機能に直接触れる必要がありません。描画中
の作品は、プログラム終了時に保存され、再開時に表示されます。作品を保存する
ために、ファイル名をつけたりキーボードを使う必要はありません。保存された作
品は、縮小画像の一覧から選択するだけで読み込むことができ、コンピューターの
他のファイルにアクセスすることはありません。
-
-操作方法
+
+→ 操作方法 ←
Tux Paint には、ボタンのサイズ拡大、UIフォントの変更、キーボードや他の入力
デバイス(ジョイスティック、ゲームパッドなど)を用いたカーソル操作、オンス
クリーンキーボード、マウスクリックの固定など、操作性に関する多くのオプショ
ンが用意されています。
+
-
-C. 著作権
+ ### C. 著作権 ###
Tux Paint は、オープンソースのプロジェクトで、GNUの一般公衆利用許諾(GPL)基づ
き公開されているフリーソフトウェアです。このソフトウェアは無料で、プログラムの
@@ -95,62 +95,76 @@ Tux Paint は、オープンソースのプロジェクトで、GNUの一般公
ライセンスの全文は、COPYING.txtをお読みください。
-D. Tux Paint バージョン 0.9.34 での変更点
+ ### D. Tux Paint バージョン 0.9.34 での変更点 ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-ブラシの追加
+
+→ ブラシの追加 ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
全ての変更点については、CHANGES.txt をお読みください。
II. Tux Paint の使い方
-A. Tux Paint の起動
+ ### A. Tux Paint の起動 ###
-1. Linux または Unix のユーザー
+## 1. Linux または Unix のユーザー ##
KDE あるいは GNOME のメニューの「グラフィックス」以下に、起動アイコンが設定され
ているはずです。
@@ -161,7 +175,7 @@ KDE あるいは GNOME のメニューの「グラフィックス」以下に、
エラーが発生した場合は、端末にその内容が表示されます。(標準エラー出力)
-2. Windows のユーザー
+## 2. Windows のユーザー ##
[Tux Paint アイコン]
Tux Paint
@@ -180,33 +194,36 @@ KDE あるいは GNOME のメニューの「グラフィックス」以下に、
ZIP ファイルを用いた場合、「Tux Paint」のフォルダは、任意の場所に配置できます。
-3. macOS のユーザー
+## 3. macOS のユーザー ##
"Tux Paint" のアイコンをダブルクリックします。
[起動画面]
+
-B. 起動画面
+ ### B. 起動画面 ###
Tux Paint を起動すると、タイトル画面が表示されます。
プログラムの読み込みが完了すると、何かキーを押すかマウスのクリックにより次に進
みます。(タイトル画面は、約5秒後に自動的に閉じます)
-C. メインの画面
+ ### C. メインの画面 ###
メインの画面は、次の各部に分けられます:
[どうぐ: ふで, はんこ, せん, かたち, もじ, まほう, ラベル, とりけし, やりなお
し, けしゴム, さいしょから, ひらく, セーブ, いんさつ, やめる]
-左側: ツールバー「どうぐ」
+
+→ 左側: ツールバー「どうぐ」 ←
ツールバーには、描画や編集を行うためのアイコンがあります。
-
+
[描画キャンバス]
-中央部: 描画キャンバス
+
+→ 中央部: 描画キャンバス ←
中央部の最も広い領域が描画キャンバスです。ここが絵を描く部分になります!
@@ -216,19 +233,21 @@ C. メインの画面
さい。
-
+
[セレクタ - ふで、もじ、かたち、はんこ]
-右側: セレクタ
+
+→ 右側: セレクタ ←
セレクタに表示される内容は、使用しているツールに応じて変わります。例えば、
「ふで」ツールでは、様々な種類の筆が表示され、「はんこ」ツールでは、はんこ
の画像が表示されます。
-
+
[いろ - いろ - くろ、しろ、あか、ぴんく、おれんじ、きいろ、みどり、みずいろ
、あお、むらさき、ちゃいろ、はいいろ]
-下部: カラーパレット「いろ」
+
+→ 下部: カラーパレット「いろ」 ←
使用中のツールが色をサポートしている場合、画面の下部付近に色の選択肢がパ
レットで表示されます。このパレットをクリックして色を選択すると、その色が
@@ -275,21 +294,22 @@ C. メインの画面
種設定について"のドキュメントを参照してください。
-
+
(「かたち」ツールの使い方を説明している例)
-最下部: ヘルプエリア
+
+→ 最下部: ヘルプエリア ←
画面の一番下の部分では、Linux ペンギンの Tux が、様々なヒントや関連情報をご
提供します。
+
+ ### D. 各種のツール ###
-D. 各種のツール
+## 1. 描画ツール ##
-1. 描画ツール
-
-a. ペイントブラシ「ふで」
+a. ペイントブラシ「ふで」 ←
右側のセレクタから筆の種類を、下のパレットから色を選んで、フリーハンドで描
画します。
@@ -326,8 +346,8 @@ a. ペイントブラシ「ふで」
なります。詳しくは"各種設定について"のドキュメントを参照してください。
-
-b.「はんこ」ツール
+
+b.「はんこ」ツール ←
「はんこ」ツールは、スタンプやステッカーを集めたようなものです。馬や木、月
など、あらかじめ用意された様々な写真やイラストを絵に貼り付けることができま
@@ -336,12 +356,12 @@ b.「はんこ」ツール
マウスを動かすと、スタンプが押される位置と大きさを示す輪郭線が表示されるの
で、押したい場所でクリックします。
- スタンプの分類
+ → スタンプの分類 ←
スタンプは、動物、植物、宇宙、乗り物、人物といった多くのカテゴリに分類
されています。セレクタの左右の矢印のボタンを使ってカテゴリを切り替える
ことができます。
-
- "スタンプの回転"
+
+ → "スタンプの回転" ←
右下のトグルボタンを使って、スタンプを配置する際の回転を有効にすること
ができます。スタンプを配置したらキャンバス上でマウスを動かして回転させ
@@ -356,8 +376,8 @@ b.「はんこ」ツール
📜 注: はんこの回転機能は Tux Paint バージョン 0.9.29 で追加されました。
-
- スタンプの操作
+
+ → スタンプの操作 ←
スタンプを絵に貼り付ける前に、以下の様々な効果を適用することができます
(スタンプの種類によって異なります):
@@ -375,19 +395,19 @@ b.「はんこ」ツール
トを参照してください。
-
- スタンプの効果音
+
+ → スタンプの効果音 ←
個々のスタンプごとに効果音を設定することができます。画面下部の左側のヘ
ルプエリア(Linux ペンギン "Tux"の近く)にあるボタンを押すと、効果音を
再生することができます。
+
-
-
-c.「せん」ツール
+
+c.「せん」ツール ←
様々な種類の筆と好きな色を使って直線を描くツールです。
@@ -408,8 +428,8 @@ c.「せん」ツール
イントブラシ「ふで」"の"ブラシの描画間隔"のセクションを参照して下さい。
-
-d.「かたち」ツール
+
+d.「かたち」ツール ←
簡単な図形を描きます。
@@ -417,21 +437,21 @@ d.「かたち」ツール
右下のオプションボタンで「かたち」ツールの動作を選択します:
- 真ん中から広げる
+ → 真ん中から広げる ←
最初にクリックした位置を中心として図形を拡大します。
📜 バージョン 0.9.24 までは、このような動作だけでした。
-
- 角から広げる
+
+ → 角から広げる ←
最初にクリックした位置を左上の角として図形を拡大します。これは、他の多
くのお絵かきソフトの標準的な動作です。
📜 このオプションは、バージョン 0.9.25 以降で追加されました。
-
+
⚙ 注: "noshapecontrols" オプションをつけて起動するなどして、「かたち」ツー
ルの動作の制御を無効にした場合、オプションボタンは表示されず、真ん中から図
@@ -447,7 +467,7 @@ d.「かたち」ツール
図形を広げ終わったらマウスを放します。
- 通常の動作
+ → 通常の動作 ←
ここで、キャンバス上でマウスを動かして図形を回転させることができます。
回転した図形の角度は画面の下に表示されます(「せん」ツールと同様)。
@@ -455,8 +475,8 @@ d.「かたち」ツール
最後にもう一度マウスをクリックして、図形が完成します。
-
- 簡易描画モード
+
+ → 簡易描画モード ←
簡易描画モードが設定されている場合、図形を回転させる手順は省略され、マ
ウスを放した時点で図形が描画されます。
@@ -464,11 +484,11 @@ d.「かたち」ツール
のドキュメントを参照して下さい。
+
-
-
-e.「もじ」ツール、「ラベル」ツール
+
+e.「もじ」ツール、「ラベル」ツール ←
まず、右側のセレクタからフォントを、下部のパレットから色を選択します。さら
に、テキストに太字や斜体のスタイルを適用することもできます。画面をクリック
@@ -485,7 +505,7 @@ e.「もじ」ツール、「ラベル」ツール
文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り
付ける位置をクリックした位置に移動させ、文字入力を続けることができます。
- 「もじ」ツールと「ラベル」ツールの違い
+ → 「もじ」ツールと「ラベル」ツールの違い ←
「もじ」ツールは、Tux Paint に以前からある文字入力ツールです。このツー
ルで入力した文字列は絵と一体化するため、後から文字列の内容を編集した
@@ -516,8 +536,8 @@ e.「もじ」ツール、「ラベル」ツール
り、無効にすることができます。
-
- 多言語文字入力
+
+ → 多言語文字入力 ←
Tux Paint では、様々な言語の文字を入力することができます。たいていのラ
テン文字(A-Z, ñ, è など)は、直接入力できます。また、いくつかの言語で
@@ -541,8 +561,8 @@ e.「もじ」ツール、「ラベル」ツール
す。
-
- 画面キーボード
+
+ → 画面キーボード ←
「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキー
ボード」では、キーボードレイアウトを変えたり、文字の合成(例: "a "と "e
@@ -552,11 +572,11 @@ e.「もじ」ツール、「ラベル」ツール
を参照してください。
+
-
-
-f.「ぬる」ツール
+
+f.「ぬる」ツール ←
「ぬる」ツールは、描画の連続した領域を好きな色で塗りつぶします。以下の3 つ
の塗りつぶしオプションが用意されています:
@@ -580,8 +600,8 @@ f.「ぬる」ツール
した。
-
-g.「まほう」ツール(特殊効果)
+
+g.「まほう」ツール(特殊効果) ←
「まほう」ツールは、様々な特殊なツールを集めたものです。右側のセレクタで、
「まほう」の効果を選択することができます。効果を適用する方法は、クリック+
@@ -630,8 +650,8 @@ g.「まほう」ツール(特殊効果)
は"各種設定について"のドキュメントを参照してください。
-
-h.けしゴム
+
+h.けしゴム ←
このツールは「ふで」(ペイントブラシ)と似た働きをします。どこをクリック
(またはクリック&ドラッグ)しても、作品に描いたものは消去され、描画を開始
@@ -657,11 +677,11 @@ h.けしゴム
のツールに戻ります。
+
+## 2. そのほかの操作 ##
-2. そのほかの操作
-
-a.「とりけし」と「やりなおし」
+a.「とりけし」と「やりなおし」 ←
「とりけし」ボタンをクリックすると、直前に行った操作が取り消されます。いく
つもの操作をさかのぼって取り消すことができます!
@@ -677,8 +697,8 @@ a.「とりけし」と「やりなおし」
⌨ 注: キーボードで [Control / ⌘] + [R] を押してもやりなおしできます。
-
-b.「さいしょから」
+
+b.「さいしょから」 ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -690,14 +710,14 @@ b.「さいしょから」
⌨ 注: キーボードで [Control / ⌘] + [N] を押しても新規作成ができます。
- 単色のキャンバス
+ → 単色のキャンバス ←
あらかじめ用意されている背景色のほか、レインボーパレットやカラーミキ
サーで色を選択することができます。これらは、絵を描くときにキャンバスの
下に表示されるカラーパレットにあるオプションと同じように操作します。詳
細はメインの画面 > 下部: カラーパレット「いろ」 > 色に関する特別なオプ
ションを参照。
-
- レイヤー画像
+
+ レイヤー画像 ←
o レイヤー画像には、塗り絵のページのようなもの(白黒の線で描かれ、色
を塗ることができる)や、前景レイヤーと背景レイヤーに挟まれた部分に
絵を描ける3D画像のようなものがあります。
@@ -723,8 +743,8 @@ b.「さいしょから」
トに変換することもできます。以下の「ひらく」を参照してください。
-
- 自作テンプレートの削除
+
+ → 自作テンプレートの削除 ←
「さいしょから」ダイアログで自作テンプレート(「ひらく」ダイアログの
「テンプレート」ボタンを使って作成したもの)を選択すると、リストの右下
@@ -737,15 +757,15 @@ b.「さいしょから」
⚙ 注: 「けす」ボタンは、"noerase" オプションで無効にできます。
-
+
⚙ 注:単色のキャンバスは、"newcolorslast" オプションによって、「さいしょか
ら」ダイアログの最後(スターターとテンプレートの下)に配置することができま
す。
-
-c.「ひらく」
+
+c.「ひらく」 ←
「ひらく」をクリックすると、保存されている全ての作品のリストが表示されま
す。リストが画面に収まりきらない場合は、上下の矢印のボタンでリストをスク
@@ -794,8 +814,8 @@ c.「ひらく」
できます。
-
-d.「セーブ」
+
+d.「セーブ」 ←
描画中の作品を保存します。
@@ -815,8 +835,8 @@ d.「セーブ」
⌨ 注: キーボードで [Control / ⌘] + [S] を押しても作品を保存できます。
-
-e.「いんさつ」
+
+e.「いんさつ」 ←
このボタンを押して作品を印刷します!
@@ -824,7 +844,7 @@ e.「いんさつ」
「いんさつ」ボタンを押すと、プリンターの設定画面が開きます。この機能は、フ
ルスクリーンモードでは動作しない点に注意して下さい。
- 印刷の無効化
+ → 印刷の無効化 ←
オプションで "noprint" を設定すれば、「いんさつ」のボタンを無効にするこ
とができます。
@@ -832,8 +852,8 @@ e.「いんさつ」
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
-
- 印刷機能の制限
+
+ → 印刷機能の制限 ←
オプションで "printdelay" を設定すれば、設定に応じた一定の時間ごとに1
回だけしか印刷できなくなります。
@@ -844,8 +864,8 @@ e.「いんさつ」
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
-
- 印刷コマンド
+
+ → 印刷コマンド ←
(Linux 及び Unix の場合のみ)
@@ -870,8 +890,8 @@ e.「いんさつ」
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
-
- プリンターの設定
+
+ → プリンターの設定 ←
(Windows 及び macOS)
@@ -892,8 +912,8 @@ e.「いんさつ」
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
-
- 印刷ダイアログのオプション
+
+ → 印刷ダイアログのオプション ←
標準の設定では、印刷ダイアログは、[Alt] (または [Option]) キーを押しな
がら「いんさつ」ボタンを押した場合にのみ表示されます(Linux/Unixでは、
@@ -909,17 +929,17 @@ e.「いんさつ」
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
+
-
-
-f.「スライドショー」
+
+f.「スライドショー」 ←
「スライドショー」の機能は、「ひらく」ダイアログから利用できます。Tux Paint
の中で、簡単なアニメーションや画像のスライドショーを再生することができま
す。また、選択した画像を元にアニメーションGIFを書き出すこともできます。
- 画像を選ぶ
+ → 画像を選ぶ ←
「スライド」セクションに入ると、「ひらく」ダイアログと同じように、保存
したファイルの一覧が表示されます。
@@ -933,8 +953,8 @@ f.「スライドショー」
ます。
-
- 再生スピードの設定
+
+ → 再生スピードの設定 ←
画面左下「かいし」の隣にあるのスライドバーで、スライドショーやアニメー
ションGIFのスピードを調節できます。スライドバーを一番左に設定すると、ス
@@ -946,8 +966,8 @@ f.「スライドショー」
の動作はアニメーションGIFには適用されません)
-
- Tux Paint 上での再生
+
+ → Tux Paint 上での再生 ←
Tux Paint 内でスライドショーを再生するには「かいし」ボタンをクリックし
ます。
@@ -964,8 +984,8 @@ f.「スライドショー」
ショーを終了し、作品選択の画面に戻ります。
-
- アニメーションGIFの書き出し
+
+ → アニメーションGIFの書き出し ←
右下の「かきだす」ボタンをクリックすると、選択した画像を元にアニメー
ションGIFファイルを生成します。
@@ -979,13 +999,13 @@ f.「スライドショー」
イドショー」ダイアログに戻ります。
-
+
さらに「もどる」ボタンをクリックすれば、「ひらく」ダイアログに戻ります。
-
-g.プログラムの終了
+
+g.プログラムの終了 ←
「やめる」ボタンを押すか、Tux Paint のウィンドウを閉じるか、[Escape] キーを
押せば、Tux Paint が終了します。
@@ -1012,8 +1032,8 @@ g.プログラムの終了
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
-
-h.効果音を消すには
+
+h.効果音を消すには ←
今のところ画面上には消音のためのボタンはありませんが、[Alt] + [S] キーを押
すと効果音は無効になり、もう一度押すと有効になります。
@@ -1025,11 +1045,11 @@ h.効果音を消すには
⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。
+
+ ### E. 操作方法 ###
-E. 操作方法
-
-1. マウス・トラックボールによる操作
+## 1. マウス・トラックボールによる操作 ##
Tux Paint の操作の大部分は、標準的なマウス、トラックボール、トラックパッド、お
絵かきタブレット(通常はスタイラスペンで操作)、タッチスクリーン(指やスタイラ
@@ -1042,7 +1062,7 @@ Tux Paint の操作の大部分は、標準的なマウス、トラックボー
表示されます。ただし、どのボタンからの入力も受け付けるように設定することもでき
ます(ドキュメント「各種設定について」を参照してください)。
-a. スクロール操作
+# a. スクロール操作 #
マウスホイール、トラックボールのスクロールリング、トラックパッドの「スクロー
ル」ジェスチャー(2本指での垂直移動やトラックパッドの端での垂直移動など)はスク
@@ -1052,7 +1072,7 @@ a. スクロール操作
また、これらのリストの上下にあるスクロールボタンをクリックし続ければ自動的にス
クロールします。
-b. マウスによる操作
+# b. マウスによる操作 #
上記のほかにも、マウスとして認識される以下のようなデバイスであれば、Tux Paint
の操作に使用できます:
@@ -1065,7 +1085,7 @@ Tux Paint には「マウスクリックのトグル動作」という操作設
リックでクリック&ドラッグ操作が始まり、その後のクリックで終了します。(ドキュ
メント「各種設定について」を参照してください)
-2. タブレット端末やタッチスクリーンでの操作
+## 2. タブレット端末やタッチスクリーンでの操作 ##
上述のように Tux Paint はマウスとして認識されるあらゆるデバイスータブレットや
タッチスクリーンなどーを使用することができます。これらのデバイスの多くは以下の
@@ -1076,7 +1096,7 @@ Tux Paint には「マウスクリックのトグル動作」という操作設
* けしゴムペン先機能
* マルチタッチジェスチャー
-3. ジョイスティック等のデバイスによる操作
+## 3. ジョイスティック等のデバイスによる操作 ##
Tux Paintは OS 上でジョイスティックとして表示されるあらゆるゲームコントローラー
からの入力を認識するように設定できます。USBやBluetoothで接続された最新のゲーム
@@ -1090,7 +1110,7 @@ Tux Paintは OS 上でジョイスティックとして表示されるあらゆ
たり、UndoやRedo操作を呼び出したりなど)。詳しくはドキュメント「各種設定につい
て」を参照してください。
-4. キーボードによる操作
+## 4. キーボードによる操作 ##
タックスペイントでは、キーボードからマウスポインタを操作することができます。こ
れには、マウスポインタの移動とクリック、およびインターフェイスの特定の部分を移
@@ -1099,7 +1119,7 @@ Tux Paintは OS 上でジョイスティックとして表示されるあらゆ
III. 他の画像の Tux Paint への読み込み
-A. 概要
+ ### A. 概要 ###
Tux Paint の「ひらく」ダイアログでは、Tux Paint で作成した画像だけが表示されま
す。その他の画像や写真を読み込んで編集するにはどのようにすれば良いでしょうか?
@@ -1108,29 +1128,29 @@ Tux Paint の「ひらく」ダイアログでは、Tux Paint で作成した画
換して、Tux Paint で作成した画像が保存されている "saved" フォルダにコピーしま
す。(標準では以下のフォルダ):
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\ユーザー名\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/ユーザー名/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/ユーザー名/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 注: Tux Paint で作成した画像を他のアプリケーションを使って開く場合も、これら
のフォルダからになります。しかしながら、「ひらく」ダイアログの「かきだす」の機
能を使えば、Tux Paint で作成した画像を、もっと簡単で安全にアクセスできるフォル
ダにコピーすることができます。
-B. "tuxpaint-import" スクリプトを使う
+ ### B. "tuxpaint-import" スクリプトを使う ###
Linux と Unix では、Tux Paint と同時に、シェルスクリプト "tuxpaint-import" がイ
ンストールされています。このスクリプトは、NetPBM のツール ("anytopnm") を用いて
@@ -1161,7 +1181,7 @@ Linux と Unix では、Tux Paint と同時に、シェルスクリプト "tuxpa
これで、Tux Paint を起動して、「ひらく」ダイアログから変換した画像を開くことが
できます。後は、アイコンをダブルクリックするだけです!
-C. 手動での取り込み
+ ### C. 手動での取り込み ###
Windows、MacOS、BeOS、そして Haiku のユーザーは、手動で変換作業を行う必要があり
ます。
@@ -1178,7 +1198,7 @@ Tux Paint で、描画キャンパスと異なる大きさの画像を読み込
や、フルスクリーン動作時の画面解像度に依存します。(注: 標準の解像度は 800x600
です)。以下の "イメージサイズの計算方法" をごらんください。
-1. ファイル名の付け方
+## 1. ファイル名の付け方 ##
画像は PNG 形式で保存してください。また、以下のように、Tux Paint における命名規
則である、現在の日付と時刻を用いたファイル名を使用することを強くお勧めします。
@@ -1196,7 +1216,7 @@ Tux Paint で、描画キャンパスと異なる大きさの画像を読み込
PNG ファイルを Tux Paint の "saved" ディレクトリにコピーします。(上記参照)
-2. イメージサイズの計算方法
+## 2. イメージサイズの計算方法 ##
"buttonsize" のオプションが追加されたため、この部分は全面的に書き直す必要があり
ます。とりあえずは、Tux Paint で作成した画像のサイズ(ピクセル幅と高さ)を調べ
@@ -1206,7 +1226,7 @@ IV.その他のドキュメント
このドキュメントの他、"docs" フォルダには、次のようなドキュメントがあります:
-Tux Paint の使用:
+→ Tux Paint の使用: ←
+ OPTIONS.html
コマンドライン、設定ファイルのオプションに関する詳細な情報。Tux Paint
Config を使用したくない人向け。
@@ -1215,8 +1235,8 @@ Tux Paint の使用:
+ Tux Paint に関するよくある質問("FAQ")
Tux Paint を使用する上でよくある質問への回答や問題の解決方法。
-
-Tux Paint の拡張:
+
+→ Tux Paint の拡張: ←
+ EXTENDING.html
ブラシ、はんこ、背景画像の作成方法、フォントを追加する方法、追加のスク
リーンキーボードの作成、言語入力の追加など、Tux Paint の拡張についての
@@ -1226,8 +1246,8 @@ Tux Paint の拡張:
+ SVG.html
SVG 形式のヴェクタ画像を作成する方法。
-
-技術情報:
+
+→ 技術情報: ←
+ INSTALL.html
コンパイル、インストールの手順.
+ SIGNALS.html
@@ -1235,8 +1255,8 @@ Tux Paint の拡張:
+ MAGIC-API.html
プラグインAPIを用いた独自の「まほう」ツールの作成
-
-開発の記録及びライセンス:
+
+→ 開発の記録及びライセンス: ←
+ AUTHORS.txt
作者と協力者のリスト.
+ CHANGES.txt
@@ -1244,7 +1264,7 @@ Tux Paint の拡張:
+ COPYING.txt
Tux Paint ソフトウェアのライセンス GNU 一般公衆利用許諾 (GPL)
-
+
V.お問い合わせ先
diff --git a/docs/ja_JP.UTF-8/SIGNALS.txt b/docs/ja_JP.UTF-8/SIGNALS.txt
index 5682362e8..f7598c1f2 100644
--- a/docs/ja_JP.UTF-8/SIGNALS.txt
+++ b/docs/ja_JP.UTF-8/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
-SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
+→ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@@ -32,8 +32,8 @@ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
the [Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/ja_JP.UTF-8/SVG.txt b/docs/ja_JP.UTF-8/SVG.txt
index e0db6028d..742f450f4 100644
--- a/docs/ja_JP.UTF-8/SVG.txt
+++ b/docs/ja_JP.UTF-8/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Open Source
+→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Proprietary
+
+→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/ja_JP.UTF-8/html/EXTENDING.html b/docs/ja_JP.UTF-8/html/EXTENDING.html
index 3824e7c41..b72ae764d 100644
--- a/docs/ja_JP.UTF-8/html/EXTENDING.html
+++ b/docs/ja_JP.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the width of the canvas.
@@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
+
Focusing on the center of a starter image stretched to fit the height of the canvas.
@@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
+
Focusing on the top of a starter image stretched to fit the width of the canvas.
@@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
+
Focusing on the bottom of a starter image stretched to fit the width of the canvas.
@@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
+
Focusing on the right of a starter image stretched to fit the height of the canvas.
diff --git a/docs/ja_JP.UTF-8/html/README.html b/docs/ja_JP.UTF-8/html/README.html
index 868645306..a9bd419c5 100644
--- a/docs/ja_JP.UTF-8/html/README.html
+++ b/docs/ja_JP.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- 2024年10月12日
+ 2024年10月14日
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- ブラシの追加
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[起動画面]">
+
B. 起動画面
@@ -412,6 +413,7 @@
height="254"
alt=
"[どうぐ: ふで, はんこ, せん, かたち, もじ, まほう, ラベル, とりけし, やりなおし, けしゴム, さいしょから, ひらく, セーブ, いんさつ, やめる]">
+
-
左側: ツールバー「どうぐ」
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[描画キャンバス]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[セレクタ - ふで、もじ、かたち、はんこ]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[いろ - いろ - くろ、しろ、あか、ぴんく、おれんじ、きいろ、みどり、みずいろ、あお、むらさき、ちゃいろ、はいいろ]">
+
-
@@ -486,13 +491,14 @@
使用中のツールが色をサポートしている場合、画面の下部付近に色の選択肢がパレットで表示されます。このパレットをクリックして色を選択すると、その色がツールで使用されます。(例えば、「ふで」ツールでは選択したブラシで描く色として、「ぬる」ツールでは画像の領域を塗りつぶす色として使用します)。
-
+
+

+
-
右端には色に関する3つの特別なオプションがあります。
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(「かたち」ツールの使い方を説明している例)">
+
-
diff --git a/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt b/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt
index f028c46cc..5738e657a 100644
--- a/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Tux Paint 0.9.34 クイックスタートガイド
-描画ツール
+ ### 描画ツール ###
-🖌ふで
+## 🖌ふで ##
* 右側のブラシを選択します。
* ブラシには、アニメーションするもの 🎞, 方向があるもの ✲ があり、両方を併せ持
@@ -11,7 +11,7 @@ Tux Paint 0.9.34 クイックスタートガイド
* 色を選択します("色" のセクションを参照)
* キャンバスをクリックまたはタップしてドラッグし、描画します。
-⌧はんこ
+## ⌧はんこ ##
* 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。
* 右側のスタンプを選択してください。
@@ -28,12 +28,12 @@ Tux Paint 0.9.34 クイックスタートガイド
* 音声解説付きのスタンプもあります。ヘッドフォン 🎧 ボタンを押すと、もう一度聞
くことができます。
-⚟せん
+## ⚟せん ##
* (描画ツールのセクションを参照)
* クリックまたはタップしてドラッグし、線を引きます。
-⭓かたち
+## ⭓かたち ##
* 右側の図形を選択してください。
* 右下のコントロールを使用して、図形を中心 ⧈ から広げるかコーナー ◰ から広げ
@@ -41,7 +41,7 @@ Tux Paint 0.9.34 クイックスタートガイド
* クリックまたはタップして位置を決め、ドラッグして大きさを変えます。
* ドラッグして回転させ、もう一度クリックまたはタップして描画します。
-🄰もじ
+## 🄰もじ ##
* 右側のフォントを選択します。
* 右下にあるコントロールを使用して、太字 𝗔 や斜体 𝘈 にするかを選択します。
@@ -62,7 +62,7 @@ Tux Paint 0.9.34 クイックスタートガイド
+ 左右の矢印で、キーボードレイアウトを切り替えます (例: "QWERTY" と
"ABC")
-🅰ラベル
+## 🅰ラベル ##
* (「もじ」を参照)
* ラベルは絵から離れて「浮いて」います。描画やスタンプでの上書きや、「まほ
@@ -75,7 +75,7 @@ Tux Paint 0.9.34 クイックスタートガイド
* 右下にある 🖑 ボタン押すと、ラベルはキャンバスに貼り付けられ、以後は編集でき
なくなります。
-🪣ぬる
+## 🪣ぬる ##
* 右側で塗りつぶしモードを選択します。
* 色を選択します("色" のセクションを参照)
@@ -89,7 +89,7 @@ Tux Paint 0.9.34 クイックスタートガイド
でエリアを塗りつぶします
+ あわせる - エリアの輪郭に合わせたグラデーションで塗りつぶします。
-🪄まほう
+## 🪄まほう ##
* 右側から、使いたい特殊効果ツールを選択します。
* 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。
@@ -100,26 +100,26 @@ Tux Paint 0.9.34 クイックスタートガイド
す。
* 使う際に色を選べるツールもあります。
-🖓とりけし
+## 🖓とりけし ##
* 直近の変更を元に戻します (何回でも遡って取り消すことができます)。
* ショートカット: [Control]+[Z]
-🖒やりなおし
+## 🖒やりなおし ##
* 取り消した変更をやり直します(何回の取り消しでもやり直せます)。
* ショートカット: [Control]+[R]
-◪けしゴム
+## ◪けしゴム ##
* 右側から、消しゴムの大きさと形を選びます。
* クリックまたはタップしてドラッグすると、ドラッグした部分が消去されます。
* ショートカット: [X]を押しながらクリックまたはタップ(使用中のツールによって
は、ショートカットが無効な場合があります)
-制御ツール
+ ### 制御ツール ###
-🗏さいしょから
+## 🗏さいしょから ##
* 開始するキャンバスを、単色の背景、スターター画像、テンプレートから選択しま
す。
@@ -132,7 +132,7 @@ Tux Paint 0.9.34 クイックスタートガイド
* 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。
* ショートカット: [Control]+[N]
-🕮⮫ひらく
+## 🕮⮫ひらく ##
* 以前に保存した作品を選択して開きます (書き出しや消去もできます)。
* 「🕮⮫ひらく」をクリックまたはタップして、保存した作品を開き、編集を続けま
@@ -155,26 +155,26 @@ Tux Paint 0.9.34 クイックスタートガイド
す。
* ショートカット: [Control]+[O]
-🕮⮪セーブ
+## 🕮⮪セーブ ##
* クリックまたはタップして作品を保存します。
* 以前に保存したことがある場合は、既存の作品を上書きするか、新しい作品として
保存するかを選択するよう求められます。
* ショートカット: [Control]+[S]
-🖶いんさつ
+## 🖶いんさつ ##
* クリックまたはタップして、作品を印刷します。
* [Alt] または [Option] を押しながらクリックまたはタップすると、(対応してい
る場合は)システムの印刷ダイアログが表示されます。
* ショートカット: [Control]+[P]
-🗙やめる
+## 🗙やめる ##
* クリックまたはタップして、Tux Paint を終了します。
* ショートカット: [Escape]
-いろ
+ ### いろ ###
* クリックまたはタップして、色が選べるツール(ふで、せん、かたちツール、およ
び、はんこ、まほうツール)で使用する色を選択します。
@@ -200,7 +200,7 @@ Tux Paint 0.9.34 クイックスタートガイド
+ 「⤺戻る」をクリックまたはタップすると、色の作成をを中止してダイアログを
終了します。
-描画中に利用できるショートカット:
+ ### 描画中に利用できるショートカット: ###
* [Control]+クリック/タップ - クイックピペット / カラーピッカー 💉
* [X]+クリック/タップ - クイック消しゴム ◪
diff --git a/docs/sq_AL.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/sq_AL.UTF-8/ADVANCED-STAMPS-HOWTO.txt
index 1322eea57..15be85135 100644
--- a/docs/sq_AL.UTF-8/ADVANCED-STAMPS-HOWTO.txt
+++ b/docs/sq_AL.UTF-8/ADVANCED-STAMPS-HOWTO.txt
@@ -19,7 +19,7 @@
+---------------------------------------------+
-------------------------------------------------------------------------------
-Rreth kësaj “Si-të”-je
+ ### Rreth kësaj “Si-të”-je ###
Kjo “Si-të” merr të mirëqenë se dëshironi të krijoni një stampë Tux Paint
të shkëlqyer, në formatin PNG, që nga një figurë JPEG (p.sh., një foto
@@ -35,9 +35,9 @@ Rreth kësaj “Si-të”-je
-------------------------------------------------------------------------------
-Zgjedhja e figurës është kyçe
+ ### Zgjedhja e figurës është kyçe ###
- Licencë
+ ## Licencë ##
Nëse dëshironi të parashtroni vepra te zhvilluesit e Tux Paint-it për
t’i marrë në shqyrtim për përfshirje te projekti zyrtar, ose nëse doni
@@ -60,7 +60,7 @@ Zgjedhja e figurës është kyçe
Për përdorim personal, çfarëdo figure që mund ta ndryshoni dhe përdorni
në mënyrë të ligjshme, s’duhet të jetë problem.
- Madhësi dhe Orientim Figure
+ ## Madhësi dhe Orientim Figure ##
Ju duhet një figurë që ka një orientim të dobishëm. Perspektiva është
armik. Figura që shfaqin një objekt nga qoshja, janë të vështira për
@@ -91,7 +91,7 @@ Zgjedhja e figurës është kyçe
-------------------------------------------------------------------------------
-Përgatitni Figurën
+ ### Përgatitni Figurën ###
Së pari, sigurohuni se shmangni riruajtjen e figurës si një JPEG. Kjo
shkakton humbje cilësie. Ka një mjet të posaçëm, të quajtur jpegtran që ju
@@ -130,7 +130,7 @@ Përgatitni Figurën
-------------------------------------------------------------------------------
-Përgatitni maskën
+ ### Përgatitni maskën ###
Get used to doing [Tasti Kontroll]-click and [Alt]-click on the thumbnail
images in the layers dialog. You will need this to control what you are
@@ -194,7 +194,7 @@ Përgatitni maskën
-------------------------------------------------------------------------------
-Zëvendësoni thekë dhe piksela hedhurinë
+ ### Zëvendësoni thekë dhe piksela hedhurinë ###
Ende duke parë maskën, përzgjidhni sipas ngjyrash. Zgjidhni të zezën.
Tkurreni përzgjedhjen me disa piksela, duke u kujdesur që të MOS tkurrni që
@@ -263,7 +263,7 @@ Zëvendësoni thekë dhe piksela hedhurinë
-------------------------------------------------------------------------------
-Ruajeni figurën për Tux Paint-int
+ ### Ruajeni figurën për Tux Paint-int ###
Është shumë kollaj të rrënoni punën tuaj të vështirë. Përpunuesit e
figurave mund të shkatërrojnë pa u ndjerë piksela në zona 0% të marrta.
@@ -276,7 +276,7 @@ Ruajeni figurën për Tux Paint-int
tuaja), të jeni thuajse i sigurt se do të shkatërroni krejt zonat 0% të
marrta. Ndaj, ja një mënyrë më e mirë…
- Një Mënyrë Më e Parrezik për Ruajtje
+ ## Një Mënyrë Më e Parrezik për Ruajtje ##
Tërhiqeni maskën prej dialogut të shtresave te pjesa e papërdorur e
panelit (fill pas mjetit të fundit të vizatimeve). Kjo do të krijojë
diff --git a/docs/sq_AL.UTF-8/ENVVARS.txt b/docs/sq_AL.UTF-8/ENVVARS.txt
index 6ce7785a1..1effee0fd 100644
--- a/docs/sq_AL.UTF-8/ENVVARS.txt
+++ b/docs/sq_AL.UTF-8/ENVVARS.txt
@@ -12,9 +12,9 @@
Tux Paint-i njeh një numër ndryshoresh mjedisi, qoftë drejtpërsëdrejti, qoftë
tërthorazi nga bibliotekat që përdor.
-Ndryshore mjedisi të lidhura me depozitim
+ ### Ndryshore mjedisi të lidhura me depozitim ###
-HOME
+→ HOME ←
Përcakton “drejtorinë shtëpi” të përdoruesit, që përdoret për të vendosur
kartela dhe drejtori të tjera të shumta. Në disa raste përdoret si pjesë e
@@ -31,8 +31,8 @@ HOME
dhënave — stampave, penelave, etj. — (kundrejt atyre që mund të
përdoren nga krejt sistemi)
-
-XDG_CONFIG_HOME
+
+→ XDG_CONFIG_HOME ←
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X,
vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të
@@ -43,8 +43,8 @@ XDG_CONFIG_HOME
Paint-i thjesht eksporton vizatime dhe GIF-e te “$HOME”.
-
-XDG_DATA_HOME
+
+→ XDG_DATA_HOME ←
Në Linux dhe platforma të tjera ku përdoren standardet e Grupit Desktopi X,
vendndodhja e kartelave të formësimeve të përdoruesit. Hollësisht, ku të
@@ -54,19 +54,19 @@ XDG_DATA_HOME
kalohe gjetiu.
-
-TEMP
+
+→ TEMP ←
Përcakton vendndodhjen ku mund të krijohen kartela të përkohshme. E
përdorur nga Tux Paint-i vetëm në OSe Microsoft Windows. Përdor “userdata”,
nëse s’është ujdisur.
-Ndryshore mjedisi të lidhura me gjuhët
+ ### Ndryshore mjedisi të lidhura me gjuhët ###
-LANG
-LANGUAGE
-LC_ALL
-LC_MESSAGES
+→ LANG ←
+→ LANGUAGE ←
+→ LC_ALL ←
+→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@@ -75,9 +75,9 @@ LC_MESSAGES
and finally "LANG".
+
-
-Ndryshore mjedisi të lidhura me ekranin
+ ### Ndryshore mjedisi të lidhura me ekranin ###
Sa vijon janë pak nga ndryshoret e mjedisit të mbuluara nga Simple DirectMedia
Layer (libSDL) — të cilat Tux Paint-i i përdorr për të shfaqur elementë
@@ -85,7 +85,7 @@ grafikë, për të luajtur tinguj dhe për të marrë sinjale për miun, tastier
joystick-un — dhe që mund të jenë të dobishme për për përdorues të Tux
Paint-it.
-SDL_VIDEO_ALLOW_SCREENSAVER
+→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Përcakton nëse Tux Paint-i duhet të lejojë xhirimin e një kursyesi ekrani.
Mund të vihet '1' (true) nga vetëm Tux Paint-i, duke dhënë mundësinë
@@ -93,8 +93,8 @@ SDL_VIDEO_ALLOW_SCREENSAVER
së formësimit.
-
-SDL_VIDEO_WINDOW_POS
+
+→ SDL_VIDEO_WINDOW_POS ←
Kërkesa ku të vendoset dritarja e Tux Paint-it dhe mund të përdoret për të
përcaktuar në cilin ekrani të vendoset një Tux Paint sa krejt ekrani, në
@@ -104,5 +104,5 @@ SDL_VIDEO_WINDOW_POS
“center” (që do të thotë “qendër”).
-
+
diff --git a/docs/sq_AL.UTF-8/EXTENDING.txt b/docs/sq_AL.UTF-8/EXTENDING.txt
index 87722f8c6..e453dbf4c 100644
--- a/docs/sq_AL.UTF-8/EXTENDING.txt
+++ b/docs/sq_AL.UTF-8/EXTENDING.txt
@@ -44,12 +44,12 @@ këtë, duke shtuar, ndryshuar, ose hequr kartelat ku kërkon për to Tux Paint-
Ku Venë Kartelat
-Kartela Standarde
+ ### Kartela Standarde ###
Tux Paint-i kërkon për kartelat e veta të ndryshme të të dhënave në drejtorinë
e vet 'data'.
-Linux dhe Unix
+→ Linux dhe Unix ←
Ku gjendet kjo drejtori varet nga vlera që qe caktuar për “DATA_PREFIX”,
kur u montua Tux Paint-i. Për hollësi, shihni “Dokumentim instalimit”.
@@ -63,8 +63,8 @@ Linux dhe Unix
/usr/share/tuxpaint/
-
-Windows
+
+→ Windows ←
Tux Paint-i kërkon për një drejtori të quajtur 'data' në të njëjtën
drejtori me të ekzekutueshmin. Kjo është një drejtori që instaluesi përdori
@@ -73,8 +73,8 @@ Windows
C:\Program Files\TuxPaint\data
-
-macOS
+
+→ macOS ←
Tux Paint- i i depoziton kartelat e të dhënave të veta brenda ikonës së
aplikacionit “Tux Paint” (që aktualisht është një lloj i veçantë dosjeje në
@@ -109,14 +109,14 @@ macOS
përdoruesit e Tux Paint-it.
+
-
-Kartela Personale
+ ### Kartela Personale ###
Mundeni edhe të krijoni penela, stampa, “fillesa”, gjedhe dhe shkronja në
drejtorinë (dosjen) tuaj të përdoruesit, ku t’i gjejë Tux Paint-i.
-Windows
+→ Windows ←
Dosja juaj personale Tux Paint gjedenet te “Application Data” juaj
personale. Për shembull, në Windows-e më të rinj:
@@ -124,8 +124,8 @@ Windows
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\
-
-macOS
+
+→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@@ -133,8 +133,8 @@ macOS
/Users/emër përdoruesi/Library/Application Support/TuxPaint/
-
-Linux dhe Unix
+
+→ Linux dhe Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/emër përdoruesi/.tuxpaint/".
@@ -142,7 +142,7 @@ Linux dhe Unix
Mos harroni pikën (“.”) para “tuxpaint”!
-
+
Që të shoni penelat, stampat, “fillesat”, gjedhet dhe shkronjat tuaja, krijoni
nëndrejtori nën drejtorinë tuaj personale Tux Paint të quajtuara “brushes”, “
@@ -164,7 +164,7 @@ Pikselat shkallë të grisë te PNG-ja e penelit do të vizatohen duke përdorur
ngjyrën aktualisht të përzgjedhur në Tux Paint. Pikselat me ngjyrë do të
ngjyrosen.
-Brush Descriptive Text
+ ### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@@ -174,7 +174,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
-Mbulim Përkthimesh
+→ Mbulim Përkthimesh ←
Te kartela tekst mund të shtohen rreshta shtesë për të dhënë përkthime të
përshkrimit, që të shfaqen kur Tux Paint-i xhiron në një gjuhë tjetër
@@ -193,17 +193,17 @@ Mbulim Përkthimesh
teksti prej anglishtes amerikane.
-
-Përdorues Windows-i
+
+→ Përdorues Windows-i ←
Që të përpunoni/krijoni këto kartela, përdorni NotePad ose WordPad.
Sigurohuni t’i ruani si tekst të thjeshtë dhe garantoni të kenë një zgjatim
“.txt” në fund të emrit të kartelës.
+
-
-Mundësi Penelash
+ ### Mundësi Penelash ###
Veç një formë grafike, penela mund t’i jepen edhe atribute të tjerë. Për ta
bërë këtë, ju duhet të krijoni një 'data file' për penel.
@@ -215,7 +215,7 @@ Kartela ka të njëjtin emër me figurën PNG, por një zgjatim “.dat”. (p.s
kartela e të dhënave “peneli.png”'s është kartela tekst “peneli.dat”, që
gjendet në të njëjtën drejtori.)
-Distancë Peneli
+→ Distancë Peneli ←
Që me Tux Paint version 0.9.16 tanimë mundeni të përcaktoni distancën për
penelat (domethënë, sa shpesh vizatohet me ta). Si parazgjedhje, distanca
@@ -226,8 +226,8 @@ Distancë Peneli
numri, aq më shpesh vizaton peneli.)
-
-Penela Me Animacion
+
+→ Penela Me Animacion ←
Që me Tux Paint version 0.9.16 tanimë mundeni të krijoni penela të animuar.
Teksa përdoret peneli, vizatohet çdo kuadër i animacionit.
@@ -243,8 +243,8 @@ Penela Me Animacion
“random”.
-
-Penela Me Drejtim
+
+→ Penela Me Drejtim ←
Që me Tux Paint version 0.9.16 tanimë mundeni të krijoni penela me drejtim.
Teksa përdoret peneli, vizatohen forma të ndryshme, varet nga drejtimi kah
@@ -260,8 +260,8 @@ Penela Me Drejtim
directional”.
-
-Penela Me Rrotullim
+
+→ Penela Me Rrotullim ←
Që me Tux Paint version 0.9.27 tanimë mundeni të krijoni penela që
rrotullohen. Teksa përdoret peneli, ai rrotullohet 360 gradë, varet nga
@@ -271,8 +271,8 @@ Penela Me Rrotullim
rotate”.
-
-Chaotic Brushes
+
+→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@@ -281,8 +281,8 @@ Chaotic Brushes
chaotic”.
-
-Animated Directional, Rotating, or Chaotic Brushes
+
+→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@@ -296,7 +296,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
-
+
Vendosini PNG-të e figurave të penelave (dhe çfarëdo kartelash tekst të
dhënash) te drejtoria “brushes”.
@@ -312,7 +312,7 @@ dobishme të krijohen nëndrejtori dhe nën-nëndrejtori këtu, për të sistemu
stampat. (Për shembull, mund të keni një dosje “festa” me nëndosjet “halloween”
dhe “kërshëndella”.)
-Figura stampash
+ ### Figura stampash ###
Vulat e Gomës në Tux Paint mund të krijohen nga një numër kartelash të ndara
njëra nga tjetra. Kartela që është e domosdoshme është, sigurisht, vetë figura.
@@ -343,7 +343,7 @@ formën(at). Për më tepër hollësi dhe ndihmëza, shihni “Dokumentim SVG”
hollësi se si të krijohen figura PNG që ripërmasohen në mënyrë të përsosur, kur
përdoren si stampa në Tux Paint.
-Tekst Përshkrues për Stampat
+ ### Tekst Përshkrues për Stampat ###
Tux Paint-i do të shfaqë tekst përshkrimi, kur përzgjidhet një stampë. Këto
gjenden në kartela tekst të thjeshtë me të njëjtin emër si PNG-ja apo SVG-ja,
@@ -353,7 +353,7 @@ në “stamp.txt” në të njëjtën drejtori.)
Rreshti i parë i kartelës tekst do të përdoret si përshkrimi në anglishte
amerikane i figurës së stampës. Duhet koduar si UTF-8.
-Mbulim Përkthimesh
+→ Mbulim Përkthimesh ←
Te kartela tekst mund të shtohen rreshta shtesë për të dhënë përkthime të
përshkrimit, që të shfaqen kur Tux Paint-i xhiron në një gjuhë tjetër
@@ -372,17 +372,17 @@ Mbulim Përkthimesh
teksti prej anglishtes amerikane.
-
-Përdorues Windows-i
+
+→ Përdorues Windows-i ←
Që të përpunoni/krijoni këto kartela, përdorni NotePad ose WordPad.
Sigurohuni t’i ruani si tekst të thjeshtë dhe garantoni të kenë një zgjatim
“.txt” në fund të emrit të kartelës.
+
-
-Efekte Zanore Stampash
+ ### Efekte Zanore Stampash ###
Tux Paint-i mund të luajë një efekt zanor, kur përzgjidhet një stampë. Për
shembull, tingulli i një rose që bën kuak-kuak, kur përzgjidhet një rosë, ose
@@ -391,7 +391,7 @@ mund të jenë në format “WAVE (".wav")” ose “OGG Vorbis (".ogg")” dhe
njëjti emër me figurën PNG ose SVG. (p.sh., efekti zanor për “stamp.svg” është
kartela zanore “stamp.ogg” në të njëjtën drejtori.)
-Mbulim Përkthimesh
+→ Mbulim Përkthimesh ←
Për tinguj për gjuhë të ndryshme (ta zëmë, nëse tingulli është dikush që
thotë një fjalë dhe ju doni versione të përkthyer të fjalës së thënë),
@@ -408,12 +408,12 @@ Mbulim Përkthimesh
të ngarkojë kartelën zanore “parazgjedhje”. (p.sh., “stamp.wav”)
-
+
💡 Shënim: Shihni edhe mundësinë e përdorimit të tingujve përshkrues; shihni
“Tingull Përshkrues Stampash”, më poshtë.
-Tingull Përshkrues Stampash
+ ### Tingull Përshkrues Stampash ###
Tux Paint-i mundet gjithashtu të luajë një tingull përshkrues, kur përzgjidhet
një stampë. Për shembull, tingulli i dikujt që thotë fjalën “rosë”, kur
@@ -423,7 +423,7 @@ tillë. Kartelat duhet të jenë në formatet “WAVE (".wav")” ose “OGG Vor
(p.sh., tingulli përshkrues i “stamp.svg” është kartela tingull
“stamp_desc.ogg” te e njëjta drejtori.)
-Mbulim Përkthimesh
+→ Mbulim Përkthimesh ←
Për tinguj përshkrues për gjuhë të ndryshme, krijoni gjithashtu kartela WAV
ose OGG me të dyja, “_desc” dhe etiketën e gjuhës te emri i kartelës, në
@@ -440,9 +440,9 @@ Mbulim Përkthimesh
“stamp_desc.wav”)
+
-
-Mundësi Stampash
+ ### Mundësi Stampash ###
Veç një formë grafike, një përshkrim në formë teksti, një efekt zanor dhe një
tingull përshkrues, stampa mund t’i jepen edhe atribute të tjerë. Për ta bërë
@@ -455,11 +455,11 @@ Kartela ka të njëjtin emër me figurën PNG ose SVG, por një zgjatim “.dat
(p.sh., kartela e të dhënave “stamp.png”'s është kartela tekst “stamp.dat”, që
gjendet në të njëjtën drejtori.)
-Stampa të Ngjyrosura
+→ Stampa të Ngjyrosura ←
Stamps can be made to be either "colorable" or "tintable."
- Colorable
+ → Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@@ -472,8 +472,8 @@ Stampa të Ngjyrosura
“colorable”.
-
- Tinted
+
+ → Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@@ -484,14 +484,14 @@ Stampa të Ngjyrosura
“tintable”.
-
- Mundësi Ngjyrosje:
+
+ → Mundësi Ngjyrosje: ←
Në varësi të lëndës së stampës tuaj, mund të doni që Tux Paint-i të
përdor njërën nga një numër metodash, kur e ngjyros. Shtoni një nga
rreshtat vijues te kartela e të dhënave të stampës:
- Ngjyrues normal — "tinter=normal" (parazgjedhja)
+ → Ngjyrues normal — "tinter=normal" (parazgjedhja) ←
Kjo është mënyra normale e ngjyrosjes. Së pari përcaktohet ngjyrimi
parësor i stampës. (Për shembull, një figurë luleje me një kërcell
do të ketë ngjyrën e petaleve si atë që shihet ngjyrimi parësor i
@@ -502,28 +502,28 @@ Stampa të Ngjyrosura
50% dhe riprovohet.) Në fund,figura ngjyroset. Gjithçka brenda 50%
të intervalit (p.sh., ±27°) ndryshohet për të pasur ngjyrimin e
ngjyrës së zgjedhur nga përdoruesi.
-
- Ngjyrues më i ngushtë — "tinter=narrow"
+
+ → Ngjyrues më i ngushtë — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
-
- Ngjyrues “Ç’të jetë” — "tinter=anyhue"
+
+ → Ngjyrues “Ç’të jetë” — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
-
- Ngjyrues vektorial — "tinter=vector"
+
+ → Ngjyrues vektorial — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
+
+
-
-
-
-Stampa të Pandryshueshme
+
+→ Stampa të Pandryshueshme ←
Si parazgjedhje, një vulë mund të kthehet me kokëposhtë, të shfaqet si një
figurë e pasqyruar, ose që të dyja. Kjo bëhet duke përdorur butonat e
@@ -542,8 +542,8 @@ Stampa të Pandryshueshme
nomirror” te kartela e të dhënave të stampës.
-
-Madhësi Fillestare Stampe
+
+→ Madhësi Fillestare Stampe ←
Si parazgjedhje, Tux Paint-i merr të mirëqenë se stampa juaj është në
përmasa të duhura për shfaqje pa ripërmasim në një kanavacë 608x472. Kjo qe
@@ -563,17 +563,17 @@ Madhësi Fillestare Stampe
+ "scale 2.5"
+ "scale 2:5"
-
-Përdorues Windows-i
+
+→ Përdorues Windows-i ←
Që të përpunoni/krijoni këto kartela, përdorni NotePad ose WordPad.
Sigurohuni t’i ruani si tekst të thjeshtë dhe garantoni të kenë një zgjatim
“.dat” në fund të emrit të kartelës.
+
-
-Stampa të kthyera në anë tjetër dhe të pasqyruara paraprakisht
+ ### Stampa të kthyera në anë tjetër dhe të pasqyruara paraprakisht ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@@ -614,7 +614,7 @@ Kur përdorni një figurë “fillimi”, bëni ndryshime dhe e ruani, figura
fillestare “fillesë” nuk mbishkruhet. Veç kësaj, teksa e përpunoni figurën e
re, lënda e “fillesës” origjinale mund ta prekë atë.
-Fillesa Në Stil Libri Për Ngjyrosje
+ ### Fillesa Në Stil Libri Për Ngjyrosje ###
Lloji më elementar i një “fillese” është i ngjashëm me një figurë në një libër
ngjyrosjesh. Është përvijimi i një forme, të cilën mandej mund ta ngjyrosni dhe
@@ -628,7 +628,7 @@ ose vektor SVG. Nëse e ruani si një PNG, mundeni, nëse doni, ta vizatoni si
e-zezë-dhe-e-tejdukshme, në vend se e-zezë-dhe-e-bardhë, por kjo s’është e
domosdoshme (që me Tux Paint 0.9.21).
-Fillesa Në Stil Skenash
+ ### Fillesa Në Stil Skenash ###
Tok me shtresën në stil “libri ngjyrosjesh”, mund të jepni edhe një figurë
sfond më vete, si pjesë e figurës “fillesë”. Shtresa përsipër sillet po njësoj:
@@ -670,7 +670,7 @@ Tux Paint-i. ose kur ngarkohet një tjetër figura, ose kur krijohet një e re.
(Me fjalë të tjera, nëse e bazoni vizatimin te një figurë “fillesë”, do të
ndikohet përherë prej tij.)
-Mundësi Fillesash
+ ### Mundësi Fillesash ###
Veç një figurë, fillesa mund t’i jepen edhe atribute të tjerë. Për ta bërë
këtë, ju duhet të krijoni një 'data file' për fillesë. (Shënim: Tux Paint-i
@@ -683,7 +683,7 @@ Kartela ka të njëjtin emër me figurën , por një zgjatim “.dat”. (p.sh.,
e të dhënave “starter.png”'s është kartela tekst “starter.dat”, që gjendet në
të njëjtën drejtori.)
-allowscale
+→ allowscale ←
Kur një figurë fillesë ka një tjetër përpjesëtim (gjerësi mbi lartësi) nga
ajo e kanavacës së Tux Paint-it, si parazgjedhje, do të ripërmasohet për ta
@@ -725,8 +725,8 @@ allowscale
+ Sjella parazgjedhje është të mos lejohet qethje. Kjo mund të
përcaktohet shprehimisht me “allowscale=none”.
-
-sfond
+
+→ sfond ←
Kjo mundësi ju lejon të përcaktoni se si Tux Paint-i duhet të plotësojë
pjesën e mbetur të kanavacës, kur fillesën nuk e nxë sipas njërit drejtim
@@ -744,8 +744,8 @@ sfond
“Dokumentimit të mundësive”.
-
-gravity
+
+→ gravity ←
Kjo mundësi ju lejon të përcaktoni si duhet ta vendosë Tux Paint-i një
fillesë, kur qethet në një ose disa drejtime. Si parazgjedhje, Tux Paint-i
@@ -769,6 +769,7 @@ gravity
[ Figurë e formuar si peizazh i një horizonti me diellin në mes dhe një
ndërtesë në të djathtë. ]
+
Focusing on the në qendër of a starter image stretched to fit the gjerësia
of the canvas.
@@ -776,6 +777,7 @@ gravity
[ Figurë e formuar si portret e një horizonti me diellin në mes dhe anën e
majtë të një ndërtese në të djathtë. ]
+
Focusing on the në qendër of a starter image stretched to fit the lartësia
of the canvas.
@@ -783,12 +785,14 @@ gravity
[ Figurë e formuar si peizazh e qiellit me diellin poshtë dhe majën e një
ndërtese në të djathtë. ]
+
Focusing on the në krye of a starter image stretched to fit the gjerësia of
the canvas.
[ Figurë e formuar si peizazh e truallit me diellin në krye. ]
+
Focusing on the në fund of a starter image stretched to fit the gjerësia of
the canvas.
@@ -796,13 +800,14 @@ gravity
[ Figurë e formuar si portret e një horizonti me diellin në të majtë dhe
një ndërtesë në qendër. ]
+
Focusing on the djathtas of a starter image stretched to fit the lartësia
of the canvas.
-
+
💡 Shënim: Edhe gjedhet (të përshkruara më poshtë) mund të kenë kartela
mundësish dhe aktualisht mbulojnë krejt po ato mundësi si fillesat.
@@ -846,7 +851,7 @@ Tux Paint-i. ose kur ngarkohet një tjetër figura, ose kur krijohet një e re.
ndikohet përherë prej tij.)
-Mundësi Gjedhesh
+ ### Mundësi Gjedhesh ###
Si dhe “Fillesat”, mund të përcaktohet një kartelë formësimi që përcakton se si
duhet të sillet Tux Paint-i, kur figura “gjedhe” aplikohen te kanavaca, kur ato
@@ -991,7 +996,7 @@ të cilave mund të jenë të përbashkëta për skema të ndryshme).
Si shembull, do të përdorim një tastierë QWERTY:
-Kartela përmbledhje e skemës (“qwerty.layout”)
+ ### Kartela përmbledhje e skemës (“qwerty.layout”) ###
Kjo është një kartelë tekst që përcakton kartelat e tjera të përdorura për të
përshkruar skemën dhe përshoqërimet e tasteve.
@@ -1009,7 +1014,7 @@ do të ndodhë edhe me çfarëdo teksti në vijim të një shenje “#” (sterl
Rreshti “keyboardlist” përshkruan te cila skema të kalohet, kur përdoruesi
klikon butonat majtas dhe djathtas te tastiera. (Shihni më poshtë.)
-Kartelë skeme skeme tastiere (“qwerty.h_layout”)
+ ### Kartelë skeme skeme tastiere (“qwerty.h_layout”) ###
Kjo përshkruan se sa e madhe është tastiera (si kuadrat "width × height") dhe
tregon çdo tast me kodin numerik të tastit (shihni kartelën “keymap” më
@@ -1074,7 +1079,7 @@ aktualisht përshkruhen më poshtë.
* 1 — skema pasuese (per the layout file's "keyboardlist" setting)
* 2 — skema e mëparshme (per the layout file's "keyboardlist" setting)
-Kartelë skeme tastiere (“us-intl-altgr-dead-keys.keymap”)
+ ### Kartelë skeme tastiere (“us-intl-altgr-dead-keys.keymap”) ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@@ -1114,7 +1119,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
-Composemap file ("en_US.UTF-8_Compose")
+ ### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Hartoni]" followed by "[A]" and "[E]" can be used to create the
@@ -1125,7 +1130,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
-Kartelë përcaktimesh simbolesh tastesh (“keysymdef.h”)
+ ### Kartelë përcaktimesh simbolesh tastesh (“keysymdef.h”) ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"
diff --git a/docs/sq_AL.UTF-8/FAQ.txt b/docs/sq_AL.UTF-8/FAQ.txt
index 9a48f5028..d337415a1 100644
--- a/docs/sq_AL.UTF-8/FAQ.txt
+++ b/docs/sq_AL.UTF-8/FAQ.txt
@@ -21,15 +21,15 @@
+-------------------------------------------+
-------------------------------------------------------------------------------
-Të lidhura me të vizatuarit
+ ### Të lidhura me të vizatuarit ###
-Shkronjat që shtova te Tux Paint-i shfaqin vetëm katrorë
+→ Shkronjat që shtova te Tux Paint-i shfaqin vetëm katrorë ←
Shkronjat TrueType që po përdorni mund të kenë kodim të gabuar. Nëse ka
kodim “të përshtatur”, mund të provoni t’i kaloni përmes FontForge (http://
fontforge.sourceforge.net/) për t’i shndërruar në një format ISO-8859.
(Dërgonani email, nëse ju duhet ndihmë me një palë shkronja speciale.)
-
-Mjeti Stampë paraqitet në gri!
+
+→ Mjeti Stampë paraqitet në gri! ←
Kjo do të thotë se Tux Paint-i ose s’gjeti ndonjë figurë stampë, ose iu
kërkua të mos i ngarkojë.
@@ -56,8 +56,8 @@ Mjeti Stampë paraqitet në gri!
kartelë formësimi.
-
-Përvijimet e stampave janë përherë drejtkëndore
+
+→ Përvijimet e stampave janë përherë drejtkëndore ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@@ -70,13 +70,13 @@ Përvijimet e stampave janë përherë drejtkëndore
te kartela “tuxpaint.c” në drejtorinë “src”.
-
+
-------------------------------------------------------------------------------
-Probleme Ndërfaqeje
+ ### Probleme Ndërfaqeje ###
-Miniaturat e stampave te Përzgjedhës Stampash duken keq
+→ Miniaturat e stampave te Përzgjedhës Stampash duken keq ←
Tux Paint was probably compiled with the faster, lower quality thumbnail
code enabled. Run the command: "tuxpaint --verbose-version" from a command
@@ -92,24 +92,24 @@ Miniaturat e stampave te Përzgjedhës Stampash duken keq
te kartela “tuxpaint.c” në drejtorinë “src”.
-
-Figurat te dialogu “Hap” duke keqn
+
+→ Figurat te dialogu “Hap” duke keqn ←
Ka shumë mundësi të jetë aktivizuar “Miniatura Me Cilësi të Dobët”. Shihni
“Miniaturat e stampave te Përzgjedhës Stampash duken keq”, më sipër.
-
-Krejt teksti është me të mëdha!
+
+→ Krejt teksti është me të mëdha! ←
Mundësia “me të mëdha” është e aktivizuar.
Ose ndryshojeni/hiqeni mundësinë “uppercase”, ose mund ta anashkaloni me
“--mixedcase” te rreshti i urdhrave, ose “uppercase=no” apo “mixedcase=yes”
te një kartelë formësimi.
-
-Tux Paint-i është në gjuhë tjetër
+
+→ Tux Paint-i është në gjuhë tjetër ←
Siguroni se rregullimi për vendoren tuaj është i saktë. Shihni “Tux Paint-i
s’kalon në gjuhën time”, më poshtë.
-
-Tux Paint-i s’kalon në gjuhën time
+
+→ Tux Paint-i s’kalon në gjuhën time ←
+ Përdorues të Linux-it dhe Unix-it: Sigurohuni se vendorja gjendet në
kompjuter
@@ -149,14 +149,14 @@ Tux Paint-i s’kalon në gjuhën time
https://tuxpaint.org/download/fonts/
-
+
-------------------------------------------------------------------------------
-Shtypje
+ ### Shtypje ###
-Tux Paint-i nuk bën shtypje, shfaq një gabim, ose shtyp shkarravina (Unix/
- Linux)
+→ Tux Paint-i nuk bën shtypje, shfaq një gabim, ose shtyp shkarravina (Unix/
+ Linux) ←
Tux Paint-i shtyp duke krijuar një figurë PostScript të figurës dhe duke e
dërguar te një urdhër i jashtëm shtypjeje. Si parazgjedhje, ky urdhër është
@@ -176,8 +176,8 @@ Tux Paint-i nuk bën shtypje, shfaq një gabim, ose shtyp shkarravina (Unix/
duhet të riktheheni dhe ta ndryshoni që të pranojë PostScript.
-
-Më del mesazhi “S’mund të shtypni ende!”, kur bëhem gati të shtyp
+
+→ Më del mesazhi “S’mund të shtypni ende!”, kur bëhem gati të shtyp ←
Është e aktivizuar mundësia “vonesë shtypjeje”. Mund të shtypni vetëm një
herë në çdo X sekonda.
@@ -203,8 +203,8 @@ Më del mesazhi “S’mund të shtypni ende!”, kur bëhem gati të shtyp
prisni mes shtypjesh.)
-
-Thjesht s’shtyp dot! Butoni është i çaktivizuar!
+
+→ Thjesht s’shtyp dot! Butoni është i çaktivizuar! ←
Mundësia “no print” është aktive.
@@ -226,43 +226,43 @@ Thjesht s’shtyp dot! Butoni është i çaktivizuar!
“Shtypje”) është me shenjë.
-
+
-------------------------------------------------------------------------------
-Ruajtje
+ ### Ruajtje ###
-Ku i ruan Tux Paint-i vizatimet e mia?
+→ Ku i ruan Tux Paint-i vizatimet e mia? ←
Hiq rastin kur i keni kërkuar Tux Paint-it që t’i ruaj në një vend të
caktuar (duke përdorur mundësinë “savedir”), Tux Paint-i i ruan te një
vendndodhje standarde në diskun tuaj vendor:
- Windows Windows 7, Windows 8, Windows 10, Windows 11
+ → Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\"
-
- macOS
+
+ → macOS ←
In the user's "Application Support" folder:
e.g.,
"/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/"
-
- Linux / Unix
+
+ → Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/emër përdoruesi/.tuxpaint/saved/"
-
- Haiku
+
+ → Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
Figurat depozitohen si bitmap-e PNG, të cilat, shumica e programeve modernë
(përpunuesi figurash, përpunues fjalësh, shfletues, etj), duhet të jenë në
gjendje t’i ngarkojnë.
-
-Tux Paint-i ruan përherë përmbi figurat e mia të vjetra
+
+→ Tux Paint-i ruan përherë përmbi figurat e mia të vjetra ←
Është e aktivizuar mundësia “save over”. (Kjo çaktivizon pyetjen tuaj që
shfaqet kur klikoni mbi “Ruaje”.)
@@ -287,8 +287,8 @@ Tux Paint-i ruan përherë përmbi figurat e mia të vjetra
Shihni edhe “Tux Paint-i ruan përherë një figurë të re!”, më poshtë.
-
-Tux Paint-i ruan përherë një figurë të re!
+
+→ Tux Paint-i ruan përherë një figurë të re! ←
Është e aktivizuar mundësia “never save over”. (Kjo çaktivizon pyetjen tuaj
që shfaqet kur klikoni mbi “Ruaje”.)
@@ -315,13 +315,13 @@ Tux Paint-i ruan përherë një figurë të re!
poshtë.
-
+
-------------------------------------------------------------------------------
-Probleme Audio
+ ### Probleme Audio ###
-S’ka tingull!
+→ S’ka tingull! ←
+ Së pari, kontrolloni të thjeshtat:
o A janë të lidhur dhe të ndezur altoparlantët tuaj?
o A është i ngritur volumi te altoparlantët tuaj?
@@ -382,8 +382,8 @@ S’ka tingull!
SDL_mixer dhe kryet e zhvillimit për të janë të instaluara!
-
-Tux Paint-i bën shumë zhurmë! A mund t’i mbyll zhurmat?
+
+→ Tux Paint-i bën shumë zhurmë! A mund t’i mbyll zhurmat? ←
Po, ka një numër rrugësh për të çaktivizuar tingujt në Tux Paint:
@@ -399,9 +399,9 @@ Tux Paint-i bën shumë zhurmë! A mund t’i mbyll zhurmat?
o Alternatively, recompile Tux Paint with sound support disabled.
(See above, and the 'Install' documentation.
-
-The stereo panning of sound effects is bothersome; can sound effects be
- monophonic?
+
+→ The stereo panning of sound effects is bothersome; can sound effects be
+ monophonic? ←
Xhirojeni Tux Paint-in me mundësinë “no stereo”:
@@ -412,8 +412,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Ose përdorni Tux Paint Config. dhe sigurohuni se “Aktivizo Efekte
Stereo” (nën “Video & Tingull”) s’ka shenjë.
-
-Efektet zanore dëgjohen të çuditshëm
+
+→ Efektet zanore dëgjohen të çuditshëm ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@@ -423,17 +423,17 @@ Efektet zanore dëgjohen të çuditshëm
"tuxpaint --version" to verify), and so on.)
-
+
-------------------------------------------------------------------------------
-Probleme me Mënyrën “Sa Krejt Ekrani”
+ ### Probleme me Mënyrën “Sa Krejt Ekrani” ###
-When I run Tux Paint full-screen and [Alt] + [Tasti Tab] out, the window turns
- black!
+→ When I run Tux Paint full-screen and [Alt] + [Tasti Tab] out, the window
+ turns black! ←
This is apparently a bug in the SDL library. Sorry.
-
-When I run Tux Paint full-screen, it has large borders around it
+
+→ When I run Tux Paint full-screen, it has large borders around it ←
Linux users - Your X-Window server is probably not set with the ability to
switch to the desired resolution: 800×600. (or whatever resolution you have
@@ -460,8 +460,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
-
-Tux Paint keeps running in Full Screen mode - I want it windowed!
+
+→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
Është aktivizuar mundësia “Sa krejt ekrani”.
@@ -484,21 +484,22 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
“Video & Tingull”) s’ka shenjë.
-
-How do I access other applications when Tux Paint is running in Full Screen?
+
+→ How do I access other applications when Tux Paint is running in Full Screen?
+ ←
+ Windows and Linux users, try the [Alt] + [Tasti Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Tasti Kontroll] +
[Left Arrow], then back to Tux Paint using [Tasti Kontroll] + [Right
Arrow].
-
+
-------------------------------------------------------------------------------
-Probleme të Tjera
+ ### Probleme të Tjera ###
-Tux Paint-i nuk xhiron
+→ Tux Paint-i nuk xhiron ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@@ -524,8 +525,8 @@ Tux Paint-i nuk xhiron
command-line, or "nolockfile=yes" to the configuration file.
-
-Tux Paint launches very slowly
+
+→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@@ -547,8 +548,8 @@ Tux Paint launches very slowly
fontconfig\cache
-
-S’mbyll dot Tux Paint-in
+
+→ S’mbyll dot Tux Paint-in ←
The "no quit" option is set. This disables the "Quit" button in Tux Paint's
toolbar (greying it out), and prevents Tux Paint from being exited via the
@@ -565,8 +566,8 @@ S’mbyll dot Tux Paint-in
combination on your keyboard to quit Tux Paint.)
-
-I don't want "no quit" mode enabled!
+
+→ I don't want "no quit" mode enabled! ←
Nëse Tux Paint-in po e xhironi që nga rresht urdhrash, sigurohuni se nuk po
i jepni një mundësi “--noquit”.
@@ -586,8 +587,8 @@ I don't want "no quit" mode enabled!
Daljes dhe tastin [Esc]” (nën “Thjeshtim”) s’ka shenjë.
-
-Tux Paint keeps writing weird messages to the screen / to a text file
+
+→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@@ -602,8 +603,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
te kartela “tuxpaint.c” në drejtorinë “src”.
-
-Tux Paint is using options I didn't specify!
+
+→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@@ -680,11 +681,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-
+
-------------------------------------------------------------------------------
-Ndihmë / Lidhuni Me Ne
+ ### Ndihmë / Lidhuni Me Ne ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:
diff --git a/docs/sq_AL.UTF-8/INSTALL.txt b/docs/sq_AL.UTF-8/INSTALL.txt
index c48188149..2ce8704ab 100644
--- a/docs/sq_AL.UTF-8/INSTALL.txt
+++ b/docs/sq_AL.UTF-8/INSTALL.txt
@@ -28,7 +28,7 @@
Domosdoshmëri
-Bibliotekë Simple DirectMedia Layer (libSDL)
+ ### Bibliotekë Simple DirectMedia Layer (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
-Biblioteka të Tjera
+## Biblioteka të Tjera ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
-libPNG
+→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
-
-gettext
+
+→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
-
-libpaper (vetëm për Linux/Unix)
+
+→ libpaper (vetëm për Linux/Unix) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@@ -92,8 +92,8 @@ libpaper (vetëm për Linux/Unix)
https://github.com/naota/libpaper
-
-FriBiDi
+
+→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
-
-Mbulim SVG-sh
+
+→ Mbulim SVG-sh ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
- librsvg-2 & libCairo2 (biblioteka më të reja)
+ → librsvg-2 & libCairo2 (biblioteka më të reja) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o Këto varen gjithashtu nga sa vijon:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
-
- Biblioteka SVG Më të Vjetra
+
+ → Biblioteka SVG Më të Vjetra ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o Këto varen gjithashtu nga sa vijon:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
+
-
-
-Veçori eksportimi Gif-i të Animuar
+
+→ Veçori eksportimi Gif-i të Animuar ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@@ -133,8 +133,8 @@ Veçori eksportimi Gif-i të Animuar
https://github.com/ImageOptim/libimagequant
-
-Mjete NetPBM (opsionale) S’përdoret më, si parazgjedhje
+
+→ Mjete NetPBM (opsionale) S’përdoret më, si parazgjedhje ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@@ -144,7 +144,7 @@ Mjete NetPBM (opsionale) S’përdoret më, si parazgjedhje
http://netpbm.sourceforge.net/
-
+
Përpilim dhe Instalim
@@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
-Windows
+ ### Windows ###
10 korrik 2022 Shin-ichi TOYAMA
-Ujdisje e Përpilimit
+## Ujdisje e Përpilimit ##
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes
support for building on a Windows system using MinGW/MSYS (https://
@@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
-MYSYS2
+# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
-MinGW 64bit (x86_64) compiler and tools
+# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install Përpilues 64bit
dhe mjete elementare zhvillimesh:
@@ -207,7 +207,7 @@ dhe mjete elementare zhvillimesh:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
+# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 64bit environment
+# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
-MinGW 32bit (i686) compiler and tools
+# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install Përpilues 32bit
dhe mjete elementare zhvillimesh:
@@ -264,7 +264,7 @@ dhe mjete elementare zhvillimesh:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
-32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
+# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
-Install SDL2_Pango and libunibreak on the 32bit environment
+# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
-ImageMagick
+## ImageMagick ##
ImageMagick is a compilation of command line tools to create, edit, compose, or
convert bitmap images supporting quite a large number of image formats. Tux
@@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
-Tux Paint & Tux Paint Config.
+## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
-Tux Paint Config.
+# Tux Paint Config. #
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if you
@@ -365,7 +365,7 @@ Tani mund ta montoni Tux Paint Config. si vijon:
$ cd tuxpaint-config
$ make win32
-Tux Paint
+# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@@ -393,7 +393,7 @@ collected in the directory for binary distribution "bdist" directory under
"win32". You can start them by double-clicking their executable (.exe) files in
the "bdist" directory.
-Montimi i Instaluesit të Tux Paint-it për Windows
+## Montimi i Instaluesit të Tux Paint-it për Windows ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows--installer.exe" file in the same directory.
-Përdorimi i Instaluesit të Tux Paint-it për Windows
+## Përdorimi i Instaluesit të Tux Paint-it për Windows ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
-Ndryshim Rregullimesh Duke Përdorur Shkurtoren
+## Ndryshim Rregullimesh Duke Përdorur Shkurtoren ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@@ -461,7 +461,7 @@ or just hit the [Tasti Esc] key and the box will close with no changes made
Kur të keni mbaruar, klikoni “OK”.
-Nëse Diçka Shkon Ters
+## Nëse Diçka Shkon Ters ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@@ -475,9 +475,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
-Linux/Unix
+ ### Linux/Unix ###
-Përpilim:
+## Përpilim: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@@ -488,7 +488,8 @@ shell prompt (e.g., "$"):
$ make
-Disabling SVG support (and hence Cairo, libSVG dhe svg-cairo dependencies):
+## Disabling SVG support (and hence Cairo, libSVG dhe svg-cairo dependencies):
+##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@@ -496,7 +497,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
-Çaktivizim i Tingullit, gjatë Përpilimit
+## Çaktivizim i Tingullit, gjatë Përpilimit ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@@ -504,12 +505,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
-Mundësi të tjera
+## Mundësi të tjera ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
-Nëse ju dalin gabime
+## Nëse ju dalin gabime ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@@ -517,7 +518,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
-Installng
+## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@@ -543,7 +544,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
-Ndryshim i Ku Venë Gjërat
+# Ndryshim i Ku Venë Gjërat #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@@ -552,48 +553,48 @@ default, set to "/usr/local".
Ndryshore të tjera janë:
-BIN_PREFIX
+→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
-
-DATA_PREFIX
+
+→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
-
-DOC_PREFIX
+
+→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
-
-MAN_PREFIX
+
+→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
-
-ICON_PREFIX — $(PREFIX)/share/pixmaps
-X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
-GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
-KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
+
+→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
+→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
+→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
+→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
-
-LOCALE_PREFIX
+
+→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
-
+
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
-macOS
+ ### macOS ###
5 qershor 2022 Mark Kim
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
-Kushte paraprake
+## Kushte paraprake ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@@ -629,7 +630,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
-libimagequant
+# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -641,7 +642,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
-sdl2_pango
+# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@@ -655,7 +656,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
-Si të Montohet
+## Si të Montohet ##
Thjesht, xhironi:
@@ -669,7 +670,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
-Probleme të Ditura
+## Probleme të Ditura ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@@ -686,7 +687,7 @@ Probleme të Ditura
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
-Versione të vjetër të macOS-it
+## Versione të vjetër të macOS-it ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@@ -726,7 +727,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
-Ripërpilim MacPorts
+## Ripërpilim MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@@ -750,7 +751,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
-Montimi i një Dyoreje Universale
+## Montimi i një Dyoreje Universale ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@@ -764,7 +765,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
-Android
+ ### Android ###
29 mars 2023 Pere Pujal i Carabantes (Edited by Bill
Kendrick)
@@ -773,7 +774,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
-Kushte paraprake
+## Kushte paraprake ##
Do t’ju duhen versione të freskët të:
@@ -798,7 +799,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
-Montim
+## Montim ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@@ -827,36 +828,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
-Haiku
+ ### Haiku ###
7 maj 2023 Luc Schrijvers (Edited by Bill Kendrick)
-Kushte paraprake
+## Kushte paraprake ##
Instaloni paketat e domosdoshme në Terminal:
-32-bit:
+→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
-
-64-bit:
+
+→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
-
+
+ ←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
-Montim
+## Montim ##
make PREFIX=/boot/home/config/non-packaged
-Stampa Tux Paint-i
+## Stampa Tux Paint-i ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@@ -869,9 +871,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Çinstalim i Tux Paint-it
-Windows
+ ### Windows ###
-Duke përdorur Çinstaluesin
+## Duke përdorur Çinstaluesin ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@@ -880,12 +882,12 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
Kur të ketë mbaruar, klikoni butonin e mbylljes.
-Duke përdorur Panelin e Kontrollit
+## Duke përdorur Panelin e Kontrollit ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
-macOS
+ ### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
@@ -893,7 +895,7 @@ the configuration files, stamps, and saved pictures, may be found in
"/Users/emër përdoruesi/Library/Application Support/TuxPaint/" (individual
users).
-Linux
+ ### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must
diff --git a/docs/sq_AL.UTF-8/MAGIC-API.txt b/docs/sq_AL.UTF-8/MAGIC-API.txt
index 25e7c9561..291b64e76 100644
--- a/docs/sq_AL.UTF-8/MAGIC-API.txt
+++ b/docs/sq_AL.UTF-8/MAGIC-API.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Magic Tool Plugin API Documentation
+ ### Magic Tool Plugin API Documentation ###
Copyright © 2007-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
@@ -87,7 +87,7 @@ The C header file and command-line tool mentioned above are included with Tux
Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin
Development package".
-'Magic' tool plugin functions
+ ### 'Magic' tool plugin functions ###
'Magic' tool plugins must contain the functions listed below. Note: To avoid
'namespace' collisions, each function's name must start with the shared
@@ -95,12 +95,12 @@ object's filename (e.g., "blur.so" or "blur.dll" would have functions whose
names begin with "blur_"). This includes private functions (ones not used by
Tux Paint directly), unless you declare those as 'static'.
-Common arguments to plugin functions
+## Common arguments to plugin functions ##
Here is a description of arguments that many of your plugin's functions will
need to accept.
-magic_api * api
+→ magic_api * api ←
Pointer to a C structure containing pointers to Tux Paint functions and
other data that the plugin can (and sometimes should) use. The contents of
@@ -113,24 +113,24 @@ magic_api * api
#include "tp_magic_api.h"
-
-int which
+
+→ int which ←
An index the plugin should use to differentiate different 'Magic' tools, if
the plugin provides more than one. (If not, "which" will always be 0.) See
"Creating plugins with multiple effects", below.
-
-SDL_Surface * snapshot
+
+→ SDL_Surface * snapshot ←
A snapshot of the previous Tux Paint canvas, taken when the the mouse was
first clicked to activate the current magic tool. If you don't continuously
affect the image during one hold of the mouse button, you should base your
effects off the contents of this canvas. (That is, read from "snapshot" and
write to "canvas", below.)
-
-SDL_Surface * canvas
+
+→ SDL_Surface * canvas ←
The current Tux Paint drawing canvas. Your magical effects should end up
here!
-
-SDL_Rect * update_rect
+
+→ SDL_Rect * update_rect ←
A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint
what part of the canvas has been updated. If your effect affects a 32x32
area centered around the mouse pointer, you would fill the SDL_Rect as
@@ -152,9 +152,9 @@ SDL_Rect * update_rect
Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an
"SDL_Rect") because you need to fill in its contents. Since it is a
pointer, you access its elements via "->" (arrow) rather than "." (dot).
+
-
-Required Plugin Functions
+## Required Plugin Functions ##
Your plugin is required to contain, at the least, all of the following
functions.
@@ -164,9 +164,9 @@ filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll"
(on Windows), then the names of your functions must begin with "zoom_" (e.g.,
"zoom_get_name(...)").
-Plugin "housekeeping" functions
+# Plugin "housekeeping" functions #
-Uint32 api_version(void)
+→ Uint32 api_version(void) ←
The plugin should return an integer value representing the version of the
Tux Paint 'Magic' tool plugin API the plugin was built against. The safest
@@ -177,8 +177,8 @@ Uint32 api_version(void)
Note: Called once by Tux Paint, at startup. It is called first.
-
-int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
+
+→ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level) ←
The plugin should do any initialization here. Return '1' if initialization
was successful, or '0' if not (and Tux Paint will not present any 'Magic'
@@ -221,8 +221,8 @@ int init(magic_api * api, Uint8 disabled_features, Uint8 complexity_level)
0x00000009.
-
-int get_tool_count(magic_api * api)
+
+→ int get_tool_count(magic_api * api) ←
This should return the number of Magic tools this plugin provides to Tux
Paint.
@@ -235,8 +235,8 @@ int get_tool_count(magic_api * api)
'Magic sizes' controls).
-
-int modes(magic_api * api, int which)
+
+→ int modes(magic_api * api, int which) ←
This lets you tell Tux Paint what modes your tool can be used in; either as
a tool the user can paint with, or a tool that affects the entire drawing
@@ -258,8 +258,8 @@ int modes(magic_api * api, int which)
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-char * get_name(magic_api * api, int which)
+
+→ char * get_name(magic_api * api, int which) ←
This should return a string containing the name of a magic tool. This will
appear on the button in the 'Magic' selector within Tux Paint.
@@ -271,8 +271,8 @@ char * get_name(magic_api * api, int which)
your "get_tool_count()").
-
-int get_group(magic_api * api, int which)
+
+→ int get_group(magic_api * api, int which) ←
Use this to group tools together within sections of the 'Magic' selector. A
number of groups are pre-defined within an enum found in "tp_magic_api.h":
@@ -297,8 +297,8 @@ int get_group(magic_api * api, int which)
Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005.
-
-SDL_Surface * get_icon(magic_api * api, int which)
+
+→ SDL_Surface * get_icon(magic_api * api, int which) ←
This should return an SDL_Surface containing the icon representing the
tool. (A greyscale image with alpha, no larger than 40x40.) This will
@@ -310,8 +310,8 @@ SDL_Surface * get_icon(magic_api * api, int which)
your "get_tool_count()").
-
-char * get_description(magic_api * api, int which, int mode)
+
+→ char * get_description(magic_api * api, int which, int mode) ←
This should return a string containing the description of how to use a
particular magic tool. This will appear as a help tip, explained by Tux the
@@ -329,8 +329,8 @@ char * get_description(magic_api * api, int which, int mode)
your plugin's "get_description()" will be called three times.
-
-int requires_colors(magic_api * api, int which)
+
+→ int requires_colors(magic_api * api, int which) ←
Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in
Tux Paint will be available), or '0' if not.
@@ -339,8 +339,8 @@ int requires_colors(magic_api * api, int which)
your "get_tool_count()").
-
-Uint8 accepted_sizes(magic_api * api, int which, int mode)
+
+→ Uint8 accepted_sizes(magic_api * api, int which, int mode) ←
Return how many size variations the 'Magic' tool accepts, in the given mode
(i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool
@@ -354,8 +354,8 @@ Uint8 accepted_sizes(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-Uint8 default_size(magic_api * api, int which, int mode)
+
+→ Uint8 default_size(magic_api * api, int which, int mode) ←
Return the default size the 'Magic' tool should start out with, in the
given mode. This will be the default setting for the tool the first time it
@@ -371,8 +371,8 @@ Uint8 default_size(magic_api * api, int which, int mode)
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void shutdown(magic_api * api)
+
+→ void shutdown(magic_api * api) ←
The plugin should do any cleanup here. If you allocated any memory or used
SDL_Mixer to load any sounds during init(), for example, you should free()
@@ -381,14 +381,14 @@ void shutdown(magic_api * api)
Note: This function is called once, when Tux Paint exits.
+
+# Plugin event functions #
-Plugin event functions
-
-void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+→ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
SDL_Surface * canvas)
void switchout(magic_api * api, int which, int mode, SDL_Surface *
- snapshot, SDL_Surface * canvas)
+ snapshot, SDL_Surface * canvas) ←
switchin() is called whenever one of the plugin's Magic tools becomes
active, and switchout() is called whenever one becomes inactive. This can
@@ -422,9 +422,9 @@ void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot,
Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002.
-
-void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
- last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect)
+
+→ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface
+ * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the RGB values of
the currently-selected color in Tux Paint's 'Colors' palette. (It will be
@@ -443,9 +443,9 @@ void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface *
0x00000007.
-
-void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
- SDL_Surface * last, Uint8 size, SDL_Rect * update_rect)
+
+→ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
+ SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) ←
Tux Paint will call this function to inform the plugin of the 'Magic' tool
size option chosen. (It will be called whenever one of the plugin's Magic
@@ -458,9 +458,9 @@ void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas,
Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008.
-
-void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
- SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
+ SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -474,9 +474,9 @@ void click(magic_api * api, int which, int mode, SDL_Surface * snapshot,
click is stored within the 'snapshot' canvas.
-
-void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect)
+
+→ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
+ canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at
@@ -496,9 +496,9 @@ void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
-
-void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
- canvas, int x, int y, SDL_Rect * update_rect)
+
+→ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface
+ * canvas, int x, int y, SDL_Rect * update_rect) ←
The plugin should apply the appropriate 'Magic' tool on the 'canvas'
surface. The (x,y) coordinates are where the mouse was (within the canvas)
@@ -512,32 +512,32 @@ void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface *
called), and is still available in the 'snapshot' canvas.
+
-
-Tux Paint Functions and Data
+ ### Tux Paint Functions and Data ###
Tux Paint provides a number of helper functions that plugins may access via the
"magic_api" structure, sent to all of the plugin's functions. (See "Required
Plugin Functions," above.)
-Pixel Manipulations
+## Pixel Manipulations ##
-Uint32 getpixel(SDL_Surface * surf, int x, int y)
+→ Uint32 getpixel(SDL_Surface * surf, int x, int y) ←
Retreives the pixel value from the (x,y) coordinates of an SDL_Surface.
(You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to
a set of Uint8 RGB values.)
-
-void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel)
+
+→ void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) ←
Sets the pixel value at position (x,y) of an SDL_Surface. (You can use
SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a
Uint32 'pixel' value appropriate to the destination surface.)
-
-Uint32 xorpixel(SDL_Surface * surf, int x, int y)
+
+→ Uint32 xorpixel(SDL_Surface * surf, int x, int y) ←
Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y)
of the SDL_Surface. Applying an XOR again at the same position will return
the pixel to the original value. Useful for displaying temporary
'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool.
-SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
+→ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) ←
This accepts an existing SDL surface and creates a new one scaled to an
arbitrary size. (The original surface remains untouched.)
@@ -546,17 +546,17 @@ SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect)
the same shape (aspect ratio) as the original, meaning it may not be the
same width and height you requested. (Check the "->w" and "->h" elements of
the output "SDL_Surface *" to determine the actual size.)
+
+## Helper Functions ##
-Helper Functions
-
-int in_circle(int x, int y, int radius)
+→ int in_circle(int x, int y, int radius) ←
Returns '1' if the (x,y) location is within a circle of a particular radius
(centered around the origin: (0,0)). Returns '0' otherwise. Useful to
create 'Magic' tools that affect the canvas with a circular brush shape.
-
-void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
- int x1, int y1, int x2, int y2, int step, FUNC callback)
+
+→ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface *
+ snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) ←
This function calculates all points on a line between the coordinates
(x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback'
@@ -580,8 +580,8 @@ void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot,
exampleCallBack);
-
-Uint8 touched(int x, int y)
+
+→ Uint8 touched(int x, int y) ←
This function allows you to avoid re-processing the same pixels multiple
times when the user drags the mouse across an area of the canvas, thus
@@ -604,23 +604,23 @@ Uint8 touched(int x, int y)
examples of such effects.
+
+## Informational ##
-Informational
-
-char * tp_version
+→ char * tp_version ←
A string containing the version of Tux Paint that's running (e.g.,
"0.9.34").
-
-int canvas_w
- int canvas_h
+
+→ int canvas_w
+ int canvas_h ←
Returns the width (canvas_w) and height (canvas_h) of the drawing canvas
(in pixels).
-
-int button_down(void)
+
+→ int button_down(void) ←
A '1' is returned if the mouse button is down; '0' otherwise.
-
-char * data_directory
+
+→ char * data_directory ←
This string contains the directory where Tux Paint's data files are stored.
For example, on Linux, this may be "/usr/share/tuxpaint/".
@@ -639,11 +639,11 @@ char * data_directory
plugins/data/").
+
+## Sound Functions ##
-Sound Functions
-
-void playsound(Mix_Chunk * snd, int pan, int dist)
+→ void playsound(Mix_Chunk * snd, int pan, int dist) ←
This function plays a sound (one loaded by the SDL helper library
"SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of
@@ -660,13 +660,13 @@ void playsound(Mix_Chunk * snd, int pan, int dist)
of the 'Magic' tool effect.
-
-void stopsound(void)
+
+→ void stopsound(void) ←
This function stops playing a sound played by playsound(). It is useful to
silence effects when the user stops using the tool (in your 'release'
function).
-
-int playingsound(void)
+
+→ int playingsound(void) ←
Call this function to determine whether a magic tool sound effect is still
currently playing. Can be used by magic tools that pause and unpause their
@@ -677,8 +677,8 @@ int playingsound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void pausesound(void)
+
+→ void pausesound(void) ←
Pauses the magic tool sound effect; it may be unpaused to resume playing.
Useful when a magic tool sound is very long; avoid repeatedly playing just
@@ -689,29 +689,29 @@ void pausesound(void)
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
-
-void unpausesound(void)
+
+→ void unpausesound(void) ←
Resumes a paused magic tool sound effect, if one was playing.
Note: Added to Tux Paint 0.9.34; Magic API version 0x0000000B.
+
+## Tux Paint System Calls ##
-Tux Paint System Calls
-
-void update_progress_bar(void)
+→ void update_progress_bar(void) ←
Asks Tux Paint to animate and draw one frame of its progress bar (at the
bottom of the screen). Useful for routines that may take a long time, to
provide feedback to the user that Tux Paint has not crashed or frozen.
-
-void special_notify(int flag)
+
+void special_notify(int flag) ←
This function notifies Tux Paint of special events. Various values defined
in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|")
and sent to this function.
- SPECIAL_FLIP
+ → SPECIAL_FLIP ←
The contents of the canvas has been flipped vertically.
@@ -722,15 +722,15 @@ void special_notify(int flag)
drawing is saved.
-
- SPECIAL_MIRROR
+
+ → SPECIAL_MIRROR ←
Similar to SPECIAL_FLIP, but for magic tools that mirror the contents
of the canvas horizontally.
+
-
-
-void retract_undo(void)
+
+void retract_undo(void) ←
Each time the user clicks in the canvas while using your Magic tool, a new
snapshot of the canvas is added to the "Undo" history. This allows the user
@@ -756,45 +756,45 @@ void retract_undo(void)
Note: Added to Tux Paint 0.9.33; Magic API version 0x0000000A.
+
+## Color Conversions ##
-Color Conversions
-
-float sRGB_to_linear(Uint8 srbg)
+→ float sRGB_to_linear(Uint8 srbg) ←
Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating
point value (between 0.0 and 1.0).
-
-uint8 linear_to_sRGB(float linear)
+
+→ uint8 linear_to_sRGB(float linear) ←
Converts a linear floating point value (one between 0.0 and 1.0) to an
8-bit sRGB value (between 0 and 255).
-
-void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v)
+
+→ void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) ←
Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue,
Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and
Value between 0.0 and 1.0).
-
-void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b)
+
+→ void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) ←
Converts floating-point HSV (Hue, Saturation and Value) values (Hue between
0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB
values (between 0 and 255).
-
+
For more information, refer to the sRGB article at Wikipedia and the HSV Color
Space article at Wikipedia.
-Helper Macros in "tp_magic_api.h"
+ ### Helper Macros in "tp_magic_api.h" ###
Along with the "magic_api" C structure containing functions and data described
above, the tp_magic_api.h C header file also contains some helper macros that
you may use.
-min(x, y)
- max(x, y)
+→ min(x, y)
+ max(x, y) ←
The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will
return the value of 'x' if it is less than or equal to 'y', otherwise it
will return 'y'.
-
-clamp(lo, value, hi)
+
+→ clamp(lo, value, hi) ←
A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That
is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is
@@ -808,14 +808,14 @@ clamp(lo, value, hi)
Note: This macro is simply a #define of: "(min(max(value,lo),hi))".
+
-
-Constant Definitions in "tp_magic_api.h"
+ ### Constant Definitions in "tp_magic_api.h" ###
The following is a summary of constant values that are set (via "#define")
within the 'Magic' tool API header file.
-TP_MAGIC_API_VERSION
+→ TP_MAGIC_API_VERSION ←
This integer value represents which version of the Tux Paint 'Magic' tool
API the header corresponds to.
@@ -830,16 +830,16 @@ TP_MAGIC_API_VERSION
of Tux Paint will often run under newer versions.
-
-SPECIAL_MIRROR
- SPECIAL_FLIP
+
+→ SPECIAL_MIRROR
+ SPECIAL_FLIP ←
These are flags for Tux Paint's "special_notify()" helper function. They
are described above.
-
+
Compiling
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the C compiler's "-shared" command-line option to generate a shared object
file (".so") based on your 'Magic' tool plugin's C source code.
@@ -849,7 +849,7 @@ in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to provide additional command-line flags to your C compiler that will help it
build your plugin.
-Command-Line Example
+## Command-Line Example ##
As a stand-alone command, using the GNU C Compiler and BASH shell, for example:
@@ -862,7 +862,7 @@ to execute the command within (in this case, "tp-magic-config ..."), and use
its output as an argument to the command being executed (in this case, "gcc
...").
-Makefile Example
+## Makefile Example ##
A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look
like this:
@@ -893,7 +893,7 @@ the C file to compile, in this case "my_plugin.c".
Note: Commands listed below a Makefile target should be intented using a single
tab character.
-Advanced Makefile
+## Advanced Makefile ##
An even more generalized Makefile might look like this:
@@ -916,23 +916,23 @@ the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And
finally, the last argument is the C file to compile; "make" replaces "$<" with
the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c".
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
Installing
-Linux and other Unix-like Platforms
+ ### Linux and other Unix-like Platforms ###
Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or
in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package"
— to determine where your plugins' files should go.
-Shared Object
+## Shared Object ##
Use "tp-magic-config --pluginprefix" to determine where the plugin shared
object (".so") files should be installed. The value returned by this command
@@ -950,7 +950,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Documentation
+## Documentation ##
Use the "tp-magic-config --plugindocprefix" command to determine where
documentation for your "Magic" tools should go. The value returned by this
@@ -973,7 +973,7 @@ Note: See the note above regarding the "`" (grave) character.
Note: Currently, there is no "--localplugindocprefix" option.
-Icons, Sounds and other Data Files
+## Icons, Sounds and other Data Files ##
Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint,
to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should
@@ -997,7 +997,7 @@ As stand-alone commands, using the BASH shell, for example:
Note: See the note above regarding the "`" (grave) character.
-Putting it Together in a Makefile
+## Putting it Together in a Makefile ##
A snippet from a more generalized Makefile might look like this:
@@ -1048,11 +1048,11 @@ Paint's documentation directory.
Note: The above Makefile example assumes the user will have priveleges to
install Tux Paint plugins system-wide.
-Windows
+ ### Windows ###
TBD
-macOS
+ ### macOS ###
TBD
@@ -1131,55 +1131,55 @@ Additionally, other Tux Paint developers and users can be found on the
Glossary
-&
+→ & ←
See "ampersand"
-
-*
+
+→ * ←
See "star"
-
-->
+
+→ -> ←
See "arrow"
-
-.
+
+→ . ←
See "dot"
-
-`
+
+→ ` ←
See "grave"
-
-alpha
+
+→ alpha ←
See "RGBA"
-
-ampersand (bitwise operator)
+
+→ ampersand (bitwise operator) ←
"&". A symbol in C that acts as a bitwise "and" operator. Only bits set in
both values will be returned. For example, "11 & 6" compares the binary
values '1011' to '0110'. Only the bit in the 2's place is set, so the
result is 2 ('0010').
See also: "bit"
-
-ampersand (pointers)
+
+→ ampersand (pointers) ←
"&". A symbol in C that allows you to refer to the memory address of a
variable; that is, a pointer. (For example, consider "int i;". Later, "&i"
refers to the memory where "i" is stored, not the value of "i" itself; it
is a 'pointer to "i"'.)
See also: "star"
-
-API
+
+→ API ←
Application Programming Interface. Definition not yet presented.
-
-argument
+
+→ argument ←
A value sent to a function.
-
-arrow
+
+→ arrow ←
"->". A symbol in C that references an element within a pointer to a
struct.
-
-backquote / backtick
+
+→ backquote / backtick ←
See "grave"
-
-BASH
+
+→ BASH ←
The "Bourne Again Shell", a Unix shell and command language.
-
-bit
+
+→ bit ←
"Binary digit." Bits are the basic storage unit in a computer's memory,
disk, networking, etc. They represent either 0 or 1. (Compared to a decimal
digit, which can be anything between 0 and 9.) Just as a series of decimal
@@ -1188,97 +1188,97 @@ bit
left: ones place, tens place, hundreds place, thousands place, etc. In
binary, it is: ones place, twos place, fours place, eights place, etc.
See also: "byte"
-
-blue
+
+→ blue ←
See "RGBA"
-
-boolean 'or'
+
+→ boolean 'or' ←
A mathematical operation that results in a true value if either operand is
true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 | 0" results in
"0".)
See also: "bit"
-
-byte
+
+→ byte ←
A unit of memory made up of 8 bits. As a signed value, it can represent
-128 through 127. As an unsigned value, it can represent 0 through 255. As
a series of bits, for example, the byte "00001100" represents the decimal
value 12.
See also: "bit"
-
-C enumeration
+
+→ C enumeration ←
A construct in C that allows you to label numeric values (usually starting
at 0 and incrementing by one). (e.g., "enum { ONE, TWO, THREE };"
-
-C function / C function prototype / C header file
+
+→ C function / C function prototype / C header file ←
Definition not yet presented.
See also: "C function prototype"
-
-C pointer
+
+→ C pointer ←
A variable that contains the location of a piece of memory; usually used to
'point' to another variable. Since C functions can only return one value as
a result, pointers are often sent to functions to allow the function to
change the values of multiple variables. (For example, Tux Paint's
"rgbtohsv()" and "hsvtorgb()".)
-
-C structure
+
+→ C structure ←
A construct in C that allows you to declare a new variable 'type' which may
contain other types within. For example, SDL's "SDL_Rect" contains four
integer values, the coordinates of the rectangle (X,Y), and its dimensions
(width and height).
-
-callback / channel
+
+→ callback / channel ←
Definition not yet presented.
-
-click
+
+→ click ←
The action of pressing a button on a mouse, tapping a touchscreen, or
pressing a stylus to a tablet.
See also:
+ drag
+ release
-
-colorspace
+
+→ colorspace ←
Definition not yet presented.
See also:
+ RGBA
+ HSV
-
-coordinates
+
+→ coordinates ←
A set of numbers corresponding to a physical position; for example, in a
two-dimensional (2D) image, "X" and "Y" coordinates specify the position
across (left-to-right) and down the image, respectively. In SDL, the
coordinates (0,0) is the top-leftmost pixel of a surface.
-
-#define
+
+→ #define ←
A C statement that defines a substitution that can occur later in the code.
Generally used for constant values (e.g., "#define RADIUS 16"; all
instances of "RADIUS" will be replaced with "16"), but can also be used to
create macros. Typically placed within C header files.
-
-dimensions
+
+→ dimensions ←
The size of an object, in terms of its width (left to right) and height
(top to bottom).
-
-.dll
+
+→ .dll ←
See "Shared Object"
-
-dot
+
+→ dot ←
".". A symbol in C that references an element within a struct.
See also:
+ C structure
+ arrow
-
-drag
+
+→ drag ←
The action of moving a mouse while the button remains held, or moving a
finger or stylus across a screen or tablet, without removing it.
See also:
+ click
+ release
-
-element
+
+→ element ←
A variable stored within a C structure. (Example: "w" and "h" elements of
SDL_Surface store the surface's width and height, respectively.)
See also:
@@ -1286,143 +1286,143 @@ element
+ dot
+ arrow
-
-enum
+
+→ enum ←
See "C enumeration"
-
-float
+
+→ float ←
See "floating point"
-
-floating point
+
+→ floating point ←
Definition not yet presented.
See also: "integer"
-
-format
+
+→ format ←
An SDL_Surface element (a pointer to an SDL_PixelFormat structure) that
contains information about a surface; for example, the number of bits used
to represent each pixel).
Refer to the "SDL_PixelFormat(3)" man page.
-
-free()
+
+→ free() ←
A C function that frees (deallocates) memory allocated by other C functions
(such as "strdup()").
Refer to the "malloc(3)" man page.
-
-function
+
+→ function ←
See "C function"
-
-gcc
+
+→ gcc ←
See "GNU C Compiler"
-
-GIMP
+
+→ GIMP ←
GNU Image Manipulation Program, an Open Source image manipulation and paint
program.
See also: "Krita"
-
-GNU C Compiler
+
+→ GNU C Compiler ←
The GNU C compiler, a portable Open Source package for compiling and
linking programs written in the C programming language.
Refer to the "gcc(1)" man page.
-
-grave
+
+→ grave ←
The "`" character; used by the BASH shell to use the output of a command as
the command-line arguments to another.
-
-green
+
+→ green ←
See "RGBA"
-
-.h / header / header file
+
+→ .h / header / header file ←
See "C header file"
-
-HSV
+
+→ HSV ←
Hue, Saturation and Value.Definition not yet presented.
See also:
+ RGBA
+ colorspace
-
-hue
+
+→ hue ←
See "HSV"
-
-IMG_Load()
+
+→ IMG_Load() ←
An SDL_image function that loads an image file (e.g., a PNG) and returns it
as an "SDL_Surface *".
-
-#include
+
+→ #include ←
A C statement that asks the compiler to read the contents of another file
(usually a header file).
-
-int
+
+→ int ←
See "integer"
-
-integer
+
+→ integer ←
Definition not yet presented.
See also: "floating point"
-
-Krita
+
+→ Krita ←
An Open Source image manipulation and paint program.
See also: "GIMP"
-
-libSDL
+
+→ libSDL ←
See "Simple DirectMedia Layer"
-
-linear
+
+→ linear ←
Definition not yet presented.
-
-macro
+
+→ macro ←
A C construct that looks similar to a C function, but is simply a #define
that is expanded 'inline'. For example, if you declared the macro "#define
ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that line of
code would literally expand to "c = ((1) + (2));", or more simply, "c = 1 +
2;".
-
-Magic tool
+
+→ Magic tool ←
One of a number of effects or drawing tools in Tux Paint, made available
via the "Magic" tool button.
-
-magic_api
+
+→ magic_api ←
A C structure that is passed along to a plugin's functions that exposes
data and functions within the running copy of Tux Paint.
-
-make
+
+→ make ←
A utility that automatically determines which pieces of a larger program
need to be recompiled, and issues the commands to recompile them.
See also: "Makefile"
-
-Makefile
+
+→ Makefile ←
A text file used by the "make" utility; it describes the relationships
among files in your program, and the commands for updating each file. (For
example, to compile a human-readable source-code file into a
computer-readable executable program file.)
-
-Mix_Chunk *
+
+→ Mix_Chunk * ←
(A pointer to) a C structure defined by SDL_mixer that contains a sound.
-
-Mix_FreeChunk()
+
+→ Mix_FreeChunk() ←
An SDL_mixer function that frees (deallocates) memory allocated for an
SDL_mixer sound 'chunk' ("Mix_Chunk *").
-
-Mix_LoadWAV()
+
+→ Mix_LoadWAV() ←
An SDL_mixer function that loads a sound file (WAV, Ogg Vorbis, etc.) and
returns it as a "Mix_Chunk *".
-
-namespace
+
+→ namespace ←
Definition not yet presented.
-
-.ogg
+
+→ .ogg ←
See "Ogg Vorbis"
-
-Ogg Vorbis / plugin
+
+→ Ogg Vorbis / plugin ←
Definition not yet presented.
See also: "WAVE"
-
-.png
+
+→ .png ←
See "Portable Network Graphics"
-
-pointer
+
+→ pointer ←
See "C pointer"
-
-Portable Network Graphics
+
+→ Portable Network Graphics ←
Portable Network Graphics. An extensible file format for the lossless,
portable, well-compressed storage of raster images. It's the file format
Tux Paint uses to save images, and for its brushes and stamps. It's an easy
@@ -1430,42 +1430,42 @@ Portable Network Graphics
transparency), excellent for use in graphics programs like Tux Paint.
Refer to the "png(5)" man page.
See also: "Scalable Vector Graphic"
-
-prototype
+
+→ prototype ←
See "C function prototype"
-
-red
+
+→ red ←
See "RGBA"
-
-release
+
+→ release ←
The action of releasing a mouse button, or removing a finger or stylus from
a screen or tablet.
See also:
+ click
+ drag
-
-RGB
+
+→ RGB ←
See "RGBA"
-
-RGBA
+
+→ RGBA ←
Red, Green, Blue, and Alpha.Definition not yet presented.
See also:
+ HSV
+ colorspace
-
-saturation
+
+→ saturation ←
See "HSV"
-
-SDL
+
+→ SDL ←
See "Simple DirectMedia Layer"
-
-SDL_FreeSurface()
+
+→ SDL_FreeSurface() ←
A libSDL function that frees (deallocates) memory allocated for an SDL
surface ("SDL_Surface *").
-
-SDL_GetRGB()
+
+→ SDL_GetRGB() ←
A libSDL function that, given a Uint32 pixel value (e.g., one returned from
the Tux Paint's Magic tool API helper function "getpixel()"), the format of
the surface the pixel was taken from, and pointers to three Uint8
@@ -1477,12 +1477,12 @@ SDL_GetRGB()
+ SDL_MapRGB()
+ RGBA
-
-SDL_image
+
+→ SDL_image ←
A library on top of libSDL that can load various kinds of image files
(e.g., PNG) and return them as an "SDL_Surface *".
-
-SDL_MapRGB()
+
+→ SDL_MapRGB() ←
A libSDL function that, given the format of a surface and Uint8 values
representing Red, Green and Blue values for a pixel, returns a Uint32 pixel
value that can be placed in the surface (e.g., using Tux Paint's Magic tool
@@ -1493,35 +1493,35 @@ SDL_MapRGB()
+ SDL_GetRGB()
+ RGBA
-
-SDL_mixer
+
+→ SDL_mixer ←
A library on top of libSDL that can load various kinds of sound files (WAV,
Ogg Vorbis, etc.) and play back multiple sounds at once (mix them).
-
-SDL_Rect
+
+→ SDL_Rect ←
A C structure defined by libSDL that represents a rectangular area. It
contains elements representing the coordinates of the top left corner of
the rectange (x,y) and the dimensions of the rectangle (w,h).
Refer to the "SDL_Rect(3)" man page.
-
-SDL_Surface *
+
+→ SDL_Surface * ←
(A pointer to) a C structure defined by libSDL that contains a drawing
surface.
Refer to the "SDL_Surface(3)" man page.
-
-shared object
+
+→ shared object ←
A piece of code that's compiled separately from the main application, and
loaded dynamically, at runtime.
-
-shell
+
+→ shell ←
See "BASH"
-
-Simple DirectMedia Layer
+
+→ Simple DirectMedia Layer ←
The Simple DirectMedia Layer (libSDL) is a programming library that
provides portable low-level access to a video framebuffer, audio output,
and mouse and keyboard input. (See: http://www.libsdl.org/)
-
-snprintf()
+
+→ snprintf() ←
A C function, related to "printf()", which takes a 'format' string and one
or more additional arguments, and puts them together. "snprintf()" takes
the resulting output and stores it into a string, making sure not to go
@@ -1530,14 +1530,14 @@ snprintf()
"Name: %s, Age: %d", "Bill", 32);" will store "Name: Bill, Age: 32" into
'str'.
Refer to the "sprintf(3)" man page.
-
-.so
+
+→ .so ←
See "shared object"
-
-sRGB
+
+→ sRGB ←
See "RGBA"
-
-star
+
+→ star ←
"*". A symbol in C that, when used in the declaration of variables (e.g.,
arguments to a function), denotes that the variable is a pointer. (For
example, "int * p;" means that "p" is a pointer to an integer.) When used
@@ -1546,30 +1546,30 @@ star
not change the value of "p", which is still a pointer to an integer. In
essence, it changed the integer that's being pointed to.)
See also: "ampersand"
-
-strdup()
+
+→ strdup() ←
A C function that allocates enough memory to store a copy of a string,
copies the string to it, and returns a "char *" pointer to the new copy.
Refer to the "strdup(3)" man page.
-
-struct
+
+→ struct ←
See "C structure"
-
-tap
+
+→ tap ←
See "click"
-
-tp-magic-config
+
+→ tp-magic-config ←
A command-line program that provides information about the installed
version of Tux Paint to plugin developers (such as what C compiler flags
they should compile with, and where plugin shared objects and data files
should be installed).
Refer to the "tp-magic-config(3)" man page.
-
-tp_magic_api.h
+
+→ tp_magic_api.h ←
A header file that defines Tux Paint's Magic tool API. Plugins must '#
include' it.
-
-Uint32
+
+→ Uint32 ←
A 32-bit, unsigned integer (defined by libSDL). In other words, four bytes
that can represent 0 through 4,294,967,295. (Typically used to hold enough
information to store three or four bytes representing a pixel's color;
@@ -1579,8 +1579,8 @@ Uint32
+ integer
+ unsigned
-
-Uint8
+
+→ Uint8 ←
An 8-bit, unsigned integer (defined by libSDL). In other words, a byte that
can represent 0 through 255.
See also:
@@ -1588,8 +1588,8 @@ Uint8
+ integer
+ unsigned
-
-unsigned
+
+→ unsigned ←
In C, a variable that can store a numeric value can be declared as either
"signed" (the default), or "unsigned". In the former case, one bit of the
value is used to denote the sign of the value (either positive or
@@ -1604,32 +1604,32 @@ unsigned
+ Uint32
+ integer
-
-value
+
+→ value ←
See "HSV"
-
-variable
+
+→ variable ←
A construct in computer programming that contains a value which can be
referenced again later by referring to the variable's name, and typically
changed later. For example, a variable to hold someone's age could be
declared as an integer: "int age;". It can be examined later — e.g., "if
(age >= 18) { /* they are an adult */ } else { /* they are not an adult */
}" — as well as modified later — e.g., age = 32; /* set age to 32 */
-
-(w,h)
+
+→ (w,h) ←
See "dimensions"
-
-.wav
+
+→ .wav ←
See "WAVE"
-
-WAVE
+
+→ WAVE ←
Waveform Audio File Format (WAVE, or WAV). Definition not yet presented.
See also: "Ogg Vorbis"
-
-(x,y)
+
+→ (x,y) ←
See "coordinates"
-
-|
+
+→ | ←
See "boolean 'or'"
-
+
diff --git a/docs/sq_AL.UTF-8/OPTIONS.txt b/docs/sq_AL.UTF-8/OPTIONS.txt
index c5bf79f97..f5df25d78 100644
--- a/docs/sq_AL.UTF-8/OPTIONS.txt
+++ b/docs/sq_AL.UTF-8/OPTIONS.txt
@@ -1,7 +1,7 @@
Tux Paint
version 0.9.34
- Dokumentim Mundësish
+ ### Dokumentim Mundësish ###
Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
https://tuxpaint.org/
@@ -45,11 +45,11 @@ each time you start it up.
The file is simply a plain text file containing the options you want enabled:
-Përdorues Linux-esh dhe Unix-esh
+ ### Përdorues Linux-esh dhe Unix-esh ###
/home/emër përdoruesi/.tuxpaintrc
-Kartelë Formësimi Për Mbarë Sistemin
+## Kartelë Formësimi Për Mbarë Sistemin ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -57,11 +57,11 @@ at:
/etc/tuxpaint/tuxpaint.conf
-Përdorues të MacOS-it
+ ### Përdorues të MacOS-it ###
/Users/emër përdoruesi/Library/Application Support/TuxPaint/tuxpaint.cfg
-Kartelë Formësimi Për Mbarë Sistemin
+## Kartelë Formësimi Për Mbarë Sistemin ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -69,14 +69,14 @@ at:
/Library/Application Support/TuxPaint/tuxpaint.cfg
-Përdorues Windows-i
+ ### Përdorues Windows-i ###
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\tuxpaint.cfg
You can use NotePad or WordPad to create this file. Be sure to save it as Plain
Text, and make sure the filename doesn't have ".txt" at the end...
-Kartelë Formësimi Për Mbarë Sistemin
+## Kartelë Formësimi Për Mbarë Sistemin ##
Before this file is read, a system-wide configuration file is read. (By
default, this configuration has no settings enabled.) It is normally located
@@ -84,7 +84,7 @@ at:
C:\Program Files\TuxPaint\tuxpaint.cfg
-Haiku Users
+ ### Haiku Users ###
/boot/home/config/settings/TuxPaint/tuxpaint.conf
@@ -97,11 +97,11 @@ Mundësi të Gatshme
The following settings can be set in the configuration file. (Command-line
settings will override these. See the "Command-Line Options" section, below.)
-Video/Tingull
+ ### Video/Tingull ###
-Video
+## Video ##
-fullscreen=yes
+→ fullscreen=yes ←
Run the program in full screen mode, rather than in a window.
@@ -110,15 +110,15 @@ fullscreen=yes
overridden by the command-line option "--windowed".
-
-fullscreen=native
+
+→ fullscreen=native ←
Run the program in full screen mode. Additionally, assume the screen's
current resolution (set by the operating system).
-
-windowsize=MADHËSI
+
+→ windowsize=MADHËSI ←
Run the program at a different size (in windowed mode) or at a different
screen resolution (in fullscreen mode), rather than the default (usually
@@ -140,8 +140,8 @@ windowsize=MADHËSI
of the display, Tux Paint will fall back to the display's dimensions.
-
-orient=portrait
+
+→ orient=portrait ←
Swaps the width/height options given to Tux Paint, useful for rotating the
window on portait displays, such as a tablet PC that's in tablet
@@ -152,16 +152,16 @@ orient=portrait
be overridden by the command-line option "--orient=landscape".
-
-native=yes
+
+→ native=yes ←
When running Tux Paint in fullscreen mode, this assumes the screen's
current resolution (overriding any "windowsize" option), as set by the
operating system.
-
-allowscreensaver=yes
+
+→ allowscreensaver=yes ←
By default, Tux Paint prevents your system's screensaver from starting up.
You can override this by using the "allowscreensaver" option. (You can also
@@ -174,11 +174,11 @@ allowscreensaver=yes
command-line option "--disablescreensaver".
+
+## Tingull ##
-Tingull
-
-nosound=yes
+→ nosound=yes ←
Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to
reenable sounds if they were disabled using this option.)
@@ -188,8 +188,8 @@ nosound=yes
cases, may be overridden by the command-line option "--sound".
-
-nostereo=yes
+
+→ nostereo=yes ←
Disable stereo panning support. (Useful for users with hearing impairment
in one ear, or places where a single speaker or headphone is being used.)
@@ -199,11 +199,11 @@ nostereo=yes
cases, may be overridden by the command-line option "--stereo".
+
+## Madhësi Ndërfaqeje ##
-Madhësi Ndërfaqeje
-
-buttonsize=MADHËSI
+→ buttonsize=MADHËSI ←
Set the pixel size of buttons in Tux Paint's user interface (overriding the
default of "48"). Useful when using very high-density displays or coarse
@@ -224,8 +224,8 @@ buttonsize=MADHËSI
stderr.)
-
-colorsrows=RRESHTA
+
+→ colorsrows=RRESHTA ←
How many rows of color palette buttons to show; useful when using a large
color palette (see "colorfile", above), and/or for use with coarse input
@@ -233,13 +233,13 @@ colorsrows=RRESHTA
and "3".
+
+ ### Mi/Tastierë ###
-Mi/Tastierë
+## Kursor ##
-Kursor
-
-nofancycursors=yes
+→ nofancycursors=yes ←
This disables the fancy mouse pointer shapes in Tux Paint, and uses your
environment's normal mouse pointer.
@@ -253,8 +253,8 @@ nofancycursors=yes
"--fancycursors".
-
-hidecursor=yes
+
+→ hidecursor=yes ←
This completely hides the mouse pointer shapes in Tux Paint.
@@ -265,11 +265,11 @@ hidecursor=yes
both cases, may be overridden by the command-line option "--showcursor".
+
+## Tastierë ##
-Tastierë
-
-noshortcuts=yes
+→ noshortcuts=yes ←
This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for
a new image, etc.)
@@ -282,11 +282,11 @@ noshortcuts=yes
both cases, may be overridden by the command-line option "--shortcuts".
+
+## Mi ##
-Mi
-
-grab=yes
+→ grab=yes ←
Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse
is confined to Tux Paint's window, and nearly all keyboard input is passed
@@ -301,8 +301,8 @@ grab=yes
cases, may be overridden by the command-line option "--dontgrab".
-
-nowheelmouse=yes
+
+→ nowheelmouse=yes ←
This disables support for the wheel on mice that have it. (Normally, the
wheel will scroll the selector menu on the right.)
@@ -312,8 +312,8 @@ nowheelmouse=yes
In both cases, may be overridden by the command-line option "--wheelmouse".
-
-nobuttondistinction=yes
+
+→ nobuttondistinction=yes ←
Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could
also be used for clicking. In version 0.9.15, it was changed so that only
@@ -330,13 +330,13 @@ nobuttondistinction=yes
command-line option "--buttondistinction".
+
+ ### Thjeshtim ###
-Thjeshtim
+## Thjeshtim Ndërfaqeje ##
-Thjeshtim Ndërfaqeje
-
-simpleshapes=yes
+→ simpleshapes=yes ←
Disable the rotation step of the 'Shape' tool. Click, drag and release is
all that will be needed to draw a shape.
@@ -347,8 +347,8 @@ simpleshapes=yes
"--complexshapes".
-
-nooutlines=yes
+
+→ nooutlines=yes ←
In this mode, much simpler outlines and 'rubber-band' lines are displayed
when using the Lines, Shapes, Stamps and Eraser tools.
@@ -361,8 +361,8 @@ nooutlines=yes
both cases, may be overridden by the command-line option "--outlines".
-
-uppercase=yes
+
+→ uppercase=yes ←
All text will be rendered only in uppercase (e.g., "Brush" will be
"BRUSH"). Useful for children who can read, but who have only learned
@@ -373,11 +373,11 @@ uppercase=yes
both cases, may be overridden by the command-line option "--mixedcase".
+
+## Madhësi Fillestare Stampe ##
-Madhësi Fillestare Stampe
-
-stampsize=MADHËSI
+→ stampsize=MADHËSI ←
Use this option to force Tux Paint to set the starting size of all stamps.
The MADHËSI value should be between 0 (smallest) and 10 (largest). The size
@@ -387,11 +387,11 @@ stampsize=MADHËSI
Specify "default" to let Tux Paint decide (its standard behavior).
+
+## Thjeshtim Kontrolli ##
-Thjeshtim Kontrolli
-
-noquit=yes
+→ noquit=yes ←
Disable the on-screen "Quit" button and prevent the [Tasti Escape] key from
quitting Tux Paint.
@@ -408,8 +408,8 @@ noquit=yes
cases, may be overridden by the command-line option "--quit".
-
-nostamps=yes
+
+→ nostamps=yes ←
This option tells Tux Paint to not load any rubber stamp images, which in
turn ends up disabling the Stamps tool.
@@ -422,8 +422,8 @@ nostamps=yes
cases, may be overridden by the command-line option "--stamps".
-
-nostampcontrols=yes
+
+→ nostampcontrols=yes ←
Some images in the Stamps tool can be mirrored, flipped, and/or have their
size changed. This option disables the controls, and only provides the
@@ -435,8 +435,8 @@ nostampcontrols=yes
"--stampcontrols".
-
-nostamprotation=yes
+
+→ nostamprotation=yes ←
This disables the rotation step of the Stamps tool, immediately placing the
stamp in its regular orientation (with any flipping or mirroring applied)
@@ -451,8 +451,8 @@ nostamprotation=yes
"--stamprotation".
-
-nomagiccontrols=yes
+
+→ nomagiccontrols=yes ←
Some Magic tools have the option of acting like a paintbrush, or affecting
the entire canvas at once. This option disables the controls, and only
@@ -464,8 +464,8 @@ nomagiccontrols=yes
"--magiccontrols".
-
-nomagicsizes=yes
+
+→ nomagicsizes=yes ←
Some Magic tools offer various size settings. This option disables the
sizing control, and only provides the tools' default sizes. (Some plugins
@@ -477,8 +477,8 @@ nomagicsizes=yes
In both cases, may be overridden by the command-line option "--magicsizes".
-
-ungroupmagictools=yes
+
+→ ungroupmagictools=yes ←
By default, the Magic tools in Tux Paint are organized into groups of
similar tools (e.g., all of the color, saturation, darken/lighten tools
@@ -494,8 +494,8 @@ ungroupmagictools=yes
option "--groupmagictools".
-
-noshapecontrols=yes
+
+→ noshapecontrols=yes ←
Disable the control buttons shown when using the Shapes tool that allow
changing how shapes are drawn — centered around the initial mouse click, or
@@ -507,8 +507,8 @@ noshapecontrols=yes
"--shapecontrols".
-
-nolabel=yes
+
+→ nolabel=yes ←
Disables the Label tool: the tool that allows text entry which can be
edited later.
@@ -518,8 +518,8 @@ nolabel=yes
cases, may be overridden by the command-line option "--label".
-
-nobrushspacing=yes
+
+→ nobrushspacing=yes ←
Disables the brush spacing option of the Paint and Lines tools. The
brushes' default spacings will be used.
@@ -533,8 +533,8 @@ nobrushspacing=yes
"--brushspacing".
-
-complexity=KOMPLEKSITET
+
+→ complexity=KOMPLEKSITET ←
Sets the complexity (expertise) level of Tux Paint, which can either
disable some Magic tools, or cause them to operate differently. (For
@@ -544,18 +544,18 @@ complexity=KOMPLEKSITET
Vlera e KOMPLEKSITET mund të jetë një nga:
- advanced (parazgjedhja)
+ → advanced (parazgjedhja) ←
"Advanced" — For users familiar with Tux Paint and who can operate more
complex tools.
-
- beginner
+
+ → beginner ←
"Beginner" — For users comfortable with Tux Paint, but where complex
tools may cause confusion or frustration.
-
- novice
+
+ → novice ←
"Novice" — For first-time Tux Paint users, users inexperienced with
computers, or those with special accessibility needs.
-
+
📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
Consult the individual Magic tools' documentation.
@@ -565,8 +565,8 @@ complexity=KOMPLEKSITET
may be overridden by the command-line option "--complexity=advanced".
-
-notemplateexport=yes
+
+→ notemplateexport=yes ←
Disables the ability to create a new Template image (based on a saved
drawing) from within the Open dialog.
@@ -580,8 +580,8 @@ notemplateexport=yes
option "--templateexport".
-
-noerase=yes
+
+→ noerase=yes ←
Disables the ability to erase saved drawings via the "Erase" button on the
Open dialog, or exported Template images (based on a saved drawing) via the
@@ -595,13 +595,13 @@ noerase=yes
cases, may be overridden by the command-line option "--erase".
+
+ ### Gjuhë ###
-Gjuhë
+## Gjuhë ##
-Gjuhë
-
-lang=GJUHË
+→ lang=GJUHË ←
Run Tux Paint in one of the supported languages. Possible choices for
LANGUAGE currently include:
@@ -863,8 +863,8 @@ lang=GJUHË
+-----------------------------------------------------------------+
-
---locale VENDORE
+
+→ --locale VENDORE ←
Run Tux Paint in one of the support languages. See the "Choosing a
Different Language" section below for the locale strings (e.g., "de_DE" for
@@ -875,8 +875,8 @@ lang=GJUHË
setting, if possible.)
-
-mirrorstamps=yes
+
+→ mirrorstamps=yes ←
For stamps that can be mirrored, this option sets them to their mirrored
shape by default.
@@ -890,11 +890,11 @@ mirrorstamps=yes
"--dontmirrorstamps".
+
+## Shkronja ##
-Shkronja
-
-sysfonts=yes
+→ sysfonts=yes ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -905,8 +905,8 @@ sysfonts=yes
both cases, may be overridden by the command-line option "--nosysfonts".
-
-alllocalefonts=yes
+
+→ alllocalefonts=yes ←
Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts
directory, including locale-specific ones (e.g., the one for Tibetan, which
@@ -922,8 +922,8 @@ alllocalefonts=yes
command-line option "--currentlocalefont".
-
-uifont=EMËR LLOJI SHKRONJASH
+
+→ uifont=EMËR LLOJI SHKRONJASH ←
This option causes Tux Paint to attempt to load fonts (for use in the Text
tool) from your operating system. Normally, Tux Paint will only load the
@@ -933,19 +933,19 @@ uifont=EMËR LLOJI SHKRONJASH
standard behavior).
+
+ ### Shtypje ###
-Shtypje
+## Leje Shtypjeje ##
-Leje Shtypjeje
-
-noprint=yes
+→ noprint=yes ←
Çaktivizoni veçorinë e shtypjeve.
-
-printdelay=SEKONDA
+
+→ printdelay=SEKONDA ←
Restrict printing so that printing can occur only once every SEKONDA
seconds.
@@ -955,11 +955,11 @@ printdelay=SEKONDA
overridden by the command-line option "--printdelay=0".
+
+## Shfaq Dialog Shtypësi ##
-Shfaq Dialog Shtypësi
-
-altprint=always
+→ altprint=always ←
This causes Tux Paint to always show the printer dialog (or, on Linux/Unix,
run the "altprintcommand") when the 'Print' button is clicked. In other
@@ -967,8 +967,8 @@ altprint=always
need to hold [Alt] every time.
-
-altprint=never
+
+→ altprint=never ←
This prevents Tux Paint from ever showing the printer dialog (or, on Linux/
Unix, run the "altprintcommand") when the 'Print' button is clicked. In
@@ -976,8 +976,8 @@ altprint=never
'Print' button.
-
-altprint=mod
+
+→ altprint=mod ←
This is the normal, default behavior. Tux Paint shows a printer dialog (or,
on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed
@@ -985,11 +985,11 @@ altprint=mod
prints without showing a dialog.
+
+## Ruaje Formësimin e Shtypësit ##
-Ruaje Formësimin e Shtypësit
-
- printcfg=yes
+ → printcfg=yes ←
(Vetëm në Windows dhe macOS)
@@ -1009,11 +1009,11 @@ Ruaje Formësimin e Shtypësit
"--noprintcfg".
+
+ ## Urdhra Shtypjeje ##
- Urdhra Shtypjeje
-
- printcommand=URDHËR
+ → printcommand=URDHËR ←
(Vetëm në Linux dhe Unix)
@@ -1030,8 +1030,8 @@ Ruaje Formësimin e Shtypësit
to version 0.9.15, you will need to change it.
-
- altprintcommand=URDHËR
+
+ → altprintcommand=URDHËR ←
(Vetëm në Linux dhe Unix)
@@ -1046,11 +1046,11 @@ Ruaje Formësimin e Shtypësit
kprinter
+
+ ## Madhësi Letre ##
- Madhësi Letre
-
- papersize=MADHËSI LETRE
+ → papersize=MADHËSI LETRE ←
(Platforms that use Tux Paint's internal PostScript generator — not
Windows, macOS, BeOS, or Haiku.)
@@ -1067,40 +1067,40 @@ Ruaje Formësimin e Shtypësit
esheet.
+
+ ### Ruajtje ###
- Ruajtje
+ ## Ruaje Përsipër Punës së Mëparshme ##
- Ruaje Përsipër Punës së Mëparshme
-
- saveover=yes
+ → saveover=yes ←
This disables the "Save over the old version...?" prompt when saving an
existing file. With this option, the older version will always be
replaced by the new version, automatically.
-
- saveover=new
+
+ → saveover=new ←
This also disables the "Save over the old version...?" prompt when
saving an existing file. This option, however, will always save a new
file, rather than overwrite the older version.
-
- saveover=ask
+
+ → saveover=ask ←
(Kjo mundësi është përsëritje e panevojshme, ngaqë kjo është
parazgjedhja.) When saving an existing drawing, you will be first asked
whether to save over the older version or not.
+
+ ## Fillimi ##
- Fillimi
-
- startblank=yes
+ → startblank=yes ←
This causes Tux Paint to display a blank canvas when it first starts
up, rather than loading the last image that was being edited.
@@ -1111,8 +1111,8 @@ Ruaje Formësimin e Shtypësit
"--startlast".
-
- newcolorslast=yes
+
+ → newcolorslast=yes ←
Places the blank color options in the New dialog at the end, so that
any Starters and/or Templates are shown first.
@@ -1123,30 +1123,30 @@ Ruaje Formësimin e Shtypësit
command-line option "--newcolorsfirst".
+
+ ## Drejtori Ruajtjesh dhe Eksportimesh ##
- Drejtori Ruajtjesh dhe Eksportimesh
-
- savedir=DREJTORI
+ → savedir=DREJTORI ←
Use this option to change where Tux Paint's "saved" directory/folder is
located, which is where Tux Paint saves and opens pictures.
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
Under a hidden directory in your home directory:
/home/emër përdoruesi/.tuxpaint/saved/
-
- Windows
+
+ → Windows ←
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\
-
- macOS
+
+ → macOS ←
/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/
-
- Haiku
+
+ → Haiku ←
/boot/home/config/settings/TuxPaint/saved/
-
+
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.
@@ -1159,8 +1159,8 @@ Ruaje Formësimin e Shtypësit
Shembull: savedir=Z:\tuxpaint\
-
- exportdir=DREJTORI
+
+ → exportdir=DREJTORI ←
Use this option to change where Tux Paint exports files — single
images, or animated GIF slideshows — for external use.
@@ -1199,11 +1199,11 @@ Ruaje Formësimin e Shtypësit
Shembull: exportdir=/home/penguin/TuxPaintExports
+
+ ## Më Tepër Mundësi Ruajtjesh ##
- Më Tepër Mundësi Ruajtjesh
-
- nosave=yes
+ → nosave=yes ←
This disables Tux Paint's ability to save files (and therefore disables
the on-screen "Save" button). It can be used in situations where the
@@ -1214,8 +1214,8 @@ Ruaje Formësimin e Shtypësit
both cases, may be overridden by the command-line option "--save".
-
- autosave=yes
+
+ → autosave=yes ←
This prevents Tux Paint from asking whether you want to save the
current picture when quitting, and assumes you do.
@@ -1226,8 +1226,8 @@ Ruaje Formësimin e Shtypësit
"--noautosave".
-
- reversesort=yes
+
+ → reversesort=yes ←
This reverses the sorting of the Open and Slideshow dialogs, placing
the newest images at the top of the list.
@@ -1238,13 +1238,13 @@ Ruaje Formësimin e Shtypësit
command-line option "--noreversesort".
+
+ ### Të dhëna ###
- Të dhëna
+ ## Lockfile ##
- Lockfile
-
- nolockfile=yes
+ → nolockfile=yes ←
By default, Tux Paint uses what's known as a 'lockfile' to prevent it
from being launched more than once in 30 seconds. (This is to avoid
@@ -1266,11 +1266,11 @@ Ruaje Formësimin e Shtypësit
"--lockfile".
+
+ ## Drejtori të Dhënash ##
- Drejtori të Dhënash
-
- datadir=DREJTORI
+ → datadir=DREJTORI ←
Use this option to change where Tux Paint looks for personal data files
(brushes, stamps, starters, templates, and fonts specific to the
@@ -1282,15 +1282,15 @@ Ruaje Formësimin e Shtypësit
If you do not override it, the default location is:
- Linux / Unix
+ → Linux / Unix ←
/home/emër përdoruesi/.tuxpaint/
-
- Windows
+
+ → Windows ←
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\
-
- macoS
+
+ → macoS ←
/Users/emër përdoruesi/Library/Application Support/TuxPaint/
-
+
📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting
or default as for "savedir" to search for data files. As of version
@@ -1302,11 +1302,11 @@ Ruaje Formësimin e Shtypësit
Shembull: datadir=/home/johnny/tuxpaint-data/
+
+ ## Kartelë Palete Ngjyrash ##
- Kartelë Palete Ngjyrash
-
- colorfile=EMËR KARTELE
+ → colorfile=EMËR KARTELE ←
You may override Tux Paint's default color palette by creating a plain
ASCII text file that describes the colors you want, and pointing to
@@ -1333,24 +1333,24 @@ Ruaje Formësimin e Shtypësit
byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0".
+
+ ### Përdorim Nga Persona Me Aftësi të Kufizuara ###
- Përdorim Nga Persona Me Aftësi të Kufizuara
+ ## Mi ##
- Mi
-
- mouse-accessibility=yes
+ → mouse-accessibility=yes ←
Nën këtë mënyrë, në vend të klikimit, tërheqjes dhe lënies (p.sh., për
të vizatuar), ju klikoni, lëvizni dhe klikoni sërish në fund të
lëvizjes.
+
+ ## Tastierë ##
- Tastierë
-
- keyboard=yes
+ → keyboard=yes ←
Kjo lejon të përdoren tastet shigjetë të tastierës për të kontrolluar
lëvizjen e treguesit të miut (p.sh., për mjedise pa mi, ose për raste
@@ -1389,18 +1389,18 @@ Ruaje Formësimin e Shtypësit
both cases, may be overridden by the command-line option "--mouse".
+
+ ## Tastierë Në Ekran ##
- Tastierë Në Ekran
-
- onscreen-keyboard=yes
+ → onscreen-keyboard=yes ←
Presents a clickable on-screen keyboard when using the Text and Label
tools.
-
- onscreen-keyboard-layout=LAYOUTNAME
+
+ → onscreen-keyboard-layout=LAYOUTNAME ←
Selects the initial layout for the on-screen keyboard when using the
Text and Label tools.
@@ -1408,8 +1408,8 @@ Ruaje Formësimin e Shtypësit
setting both is redundant.
-
- onscreen-keyboard-disable-change=yes
+
+ → onscreen-keyboard-disable-change=yes ←
Disables the possibility for changing the layout of the on-screen
keyboard when using the Text and Label tools, useful for simplifying
@@ -1423,191 +1423,191 @@ Ruaje Formësimin e Shtypësit
by the command-line option "--onscreen-keyboard-disable-change=no".
+
+ ### Joystick ###
- Joystick
+ ## Pajisja Kryesore ##
- Pajisja Kryesore
-
- joystick-dev=N
+ → joystick-dev=N ←
Specify which joystick device should be used by Tux Paint. Default
value is 0 (the first joystick).
-
- joystick-slowness=SHPEJTËSI
+
+ → joystick-slowness=SHPEJTËSI ←
Sets a delay at each axis motion, allowing to slow the joystick.
Allowed values are from 0 to 500. Default value is 15.
-
- joystick-threshold=PRAG
+
+ → joystick-threshold=PRAG ←
Sets the minimum level of axis motion to start moving the pointer.
Allowed values are from 0 to 32766. Default value is 3200.
-
- joystick-maxsteps=HAPA
+
+ → joystick-maxsteps=HAPA ←
Sets the maximum pixels the pointer will move at once. Allowed values
are from 1 to 7. Default value is 7.
+
+ ## Kapë ##
- Kapë
-
- joystick-hat-slowness=SHPEJTËSI
+ → joystick-hat-slowness=SHPEJTËSI ←
Sets a delay at each automatic motion, allowing to slow the speed of
the hat. Allowed values are from 0 to 500. Default value is 15.
-
- joystick-hat-timeout=MILISEKONDA
+
+ → joystick-hat-timeout=MILISEKONDA ←
Sets the delay after wich the pointer will start moving automatically
if the hat is keeped pushed. Allowed values are from 0 to 3000. Default
value is 1000.
+
+ ## Butona për T’u Çaktivizuar ##
- Butona për T’u Çaktivizuar
-
- joystick-buttons-ignore=BUTTON1,BUTTON2,...
+ → joystick-buttons-ignore=BUTTON1,BUTTON2,... ←
A set of joystick button numbers, as seen by SDL, that should be
ignored. Otherwise, unless they are used by one of the "joystick-btn-"
options above, buttons will be seen as a mouse left-click.
+
+## Shkurtore butonash ##
-Shkurtore butonash
-
- joystick-btn-escape=NUMËR BUTONI
+ → joystick-btn-escape=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be used
to generate a escape event. Useful to dismiss dialogs and quit.
-
- joystick-btn-brush=NUMËR BUTONI
+
+ → joystick-btn-brush=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin penela.
-
- joystick-btn-stamp=NUMËR BUTONI
+
+ → joystick-btn-stamp=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin stampa.
-
- joystick-btn-lines=NUMËR BUTONI
+
+ → joystick-btn-lines=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin për vija.
-
- joystick-btn-shapes=NUMËR BUTONI
+
+ → joystick-btn-shapes=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin për forma.
-
- joystick-btn-text=NUMËR BUTONI
+
+ → joystick-btn-text=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin për tekst.
-
- joystick-btn-label=NUMËR BUTONI
+
+ → joystick-btn-label=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin për etiketa.
-
- joystick-btn-fill=NUMËR BUTONI
+
+ → joystick-btn-fill=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin “Mbushje”.
-
- joystick-btn-magic=NUMËR BUTONI
+
+ → joystick-btn-magic=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to përzgjidhni mjetin magjik.
-
- joystick-btn-undo=NUMËR BUTONI
+
+ → joystick-btn-undo=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to thirrni mjetin zhbëje.
-
- joystick-btn-redo=NUMËR BUTONI
+
+ → joystick-btn-redo=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select mjeti i ribërjeve.
-
- joystick-btn-eraser=NUMËR BUTONI
+
+ → joystick-btn-eraser=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to select mjeti gomë.
-
- joystick-btn-new=NUMËR BUTONI
+
+ → joystick-btn-new=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for creating a new drawing.
-
- joystick-btn-open=NUMËR BUTONI
+
+ → joystick-btn-open=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to launch the dialog for opening an existing drawing.
-
- joystick-btn-save=NUMËR BUTONI
+
+ → joystick-btn-save=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to ruajeni vizatimin.
-
- joystick-btn-pgsetup=NUMËR BUTONI
+
+ → joystick-btn-pgsetup=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to nis dialogun e ujdisjes së faqes për shtypje.
-
- joystick-btn-print=NUMËR BUTONI
+
+ → joystick-btn-print=NUMËR BUTONI ←
Selects the joystick button number, as seen by SDL, that will be a
shortcut to shtype.
-
+
Anashkalim Mundësish të Formësimit të Ssistemit
@@ -1633,7 +1633,7 @@ Shkurtore butonash
Options may also be issued on the command-line when you go to launch Tux
Paint.
- --fullscreen=yes
+ → --fullscreen=yes
--fullscreen=native
--GJERËSIxLARTËSI
--orient=portrait
@@ -1715,13 +1715,14 @@ Shkurtore butonash
--reversesort
--lang GJUHË
--colorfile KARTELË
+ ←
These enable or correspond to the configuration file options described
above.
-
- --windowed
+
+ → --windowed
--800x600
--orient=landscape
--disablescreensaver
@@ -1762,14 +1763,15 @@ Shkurtore butonash
--save
--noautosave
--noreversesort
+ ←
These options can be used to override any settings made in the
configuration file. (If the option isn't set in the configuration file
(s), no overriding option is necessary.)
-
- --nosysconfig
+
+ → --nosysconfig ←
This prevents the system-wide configuration file (e.g.
"/etc/tuxpaint/tuxpaint.conf" on Linux), from being read.
@@ -1779,52 +1781,52 @@ Shkurtore butonash
used.
+
-
- Mundësi Informative Për Rresht Urdhrash
+ ### Mundësi Informative Për Rresht Urdhrash ###
The following options display some informative text on the screen. Tux
Paint doesn't actually start up and run afterwards, however.
- --version
- --verbose-version
+ → --version
+ --verbose-version ←
Display the version number and date of the copy of Tux Paint you are
running. The "--verbose-version" also lists what compile-time options
were set. (See INSTALL and FAQ).
-
- --copying
+
+ → --copying ←
Show brief license information about copying Tux Paint.
-
- --usage
+
+ → --usage ←
Display the list of available command-line options.
-
- --help
+
+ → --help ←
Display brief help on using Tux Paint.
-
- --lang help
+
+ → --lang help ←
Display a list of available languages in Tux Paint.
-
- --joystick-dev list
+
+ → --joystick-dev list ←
Display list of attached joysticks available to Tux Paint.
-
+
Zgjedhja e një Gjuhe Tjetër
@@ -1838,7 +1840,7 @@ Shkurtore butonash
Use the option "--lang help" to list the language options available.
- Gjuhë të Gatshme
+ ### Gjuhë të Gatshme ###
+-------------------------------------------------------------------------+
| | Gjuhë | Gjuhë | Input Method |
@@ -2139,7 +2141,7 @@ Shkurtore butonash
can be used to cycle through the supported input methods while the Text
tool is active.
- Ujdisje e Vendore së Mjedisit Tuaj
+ ### Ujdisje e Vendore së Mjedisit Tuaj ###
Changing your locale will affect much of your environment.
@@ -2150,7 +2152,7 @@ Shkurtore butonash
If you haven't already set your environment's locale, the following will
briefly explain how:
- Përdorues të Linux-it/Unix-it
+ ## Përdorues të Linux-it/Unix-it ##
First, be sure the locale you want to use is enabled by editing the file "/
etc/locale.gen" on your system and then running the program "locale-gen" as
@@ -2178,7 +2180,7 @@ Shkurtore butonash
setenv LANG es_ES ; \
tuxpaint
- Përdorues Windows-i
+ ## Përdorues Windows-i ##
Tux Paint will recognize the current locale and use the appropriate files
by default. So this section is only for people trying different languages.
@@ -2203,7 +2205,7 @@ Shkurtore butonash
+ Edit the value of the parameter "LANG" (create it, if it doesn't
exists).
- Shkronja Speciale
+ ### Shkronja Speciale ###
Some languages require special fonts be installed. These font files (which
are in TrueType format (TTF)), are much too large to include with the Tux
diff --git a/docs/sq_AL.UTF-8/PNG.txt b/docs/sq_AL.UTF-8/PNG.txt
index 867291f63..feb41e46c 100644
--- a/docs/sq_AL.UTF-8/PNG.txt
+++ b/docs/sq_AL.UTF-8/PNG.txt
@@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
-Si të Krijohen PNG-ra
+ ### Si të Krijohen PNG-ra ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
-GIMP & Krita
+→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
+
+→ Mjete Resht Urdhrash ←
-Mjete Resht Urdhrash
-
- NetPBM
+ → NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@@ -58,8 +58,8 @@ Mjete Resht Urdhrash
netpbm.sourceforge.net/.
-
- cjpeg/djpeg
+
+ → cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@@ -68,11 +68,11 @@ Mjete Resht Urdhrash
or to learn more, visit https://jpegclub.org/.
+
-
-
-Software Pronësor për Windows
+
+→ Software Pronësor për Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@@ -80,13 +80,13 @@ Software Pronësor për Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
-
-Përdorues të Macintosh-it
+
+→ Përdorues të Macintosh-it ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
-
+
diff --git a/docs/sq_AL.UTF-8/README.txt b/docs/sq_AL.UTF-8/README.txt
index 7d71807da..8f9dde5b2 100644
--- a/docs/sq_AL.UTF-8/README.txt
+++ b/docs/sq_AL.UTF-8/README.txt
@@ -1,12 +1,12 @@
Tux Paint
version 0.9.34
- Një program i thjeshtë vizatimi për fëmijë
+ ## Një program i thjeshtë vizatimi për fëmijë ##
Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
https://tuxpaint.org/
- 12 tetor 2024
+ 14 tetor 2024
+---------------------------------------------------+
| Pasqyrë e Lëndës |
@@ -44,7 +44,7 @@
I. Mbi Tux Paint-in
-A. Ç’është “Tux Paint”?
+ ### A. Ç’është “Tux Paint”? ###
Tux Paint is a free drawing program designed for young children (kids ages 3
and up). It has a simple, easy-to-use interface, fun sound effects, and an
@@ -52,43 +52,43 @@ encouraging cartoon mascot who helps guide children as they use the program. It
provides a blank canvas and a variety of drawing tools to help your child be
creative.
-B. Objektiva
+ ### B. Objektiva ###
-I lehtë dhe Zbavitës
+→ I lehtë dhe Zbavitës ←
Tux Paint is meant to be a simple drawing program for young children. It is
not meant as a general-purpose drawing tool. It is meant to be fun and easy
to use. Sound effects and a cartoon character help let the user know what's
going on, and keeps them entertained. There are also extra-large
cartoon-style mouse pointer shapes.
-
-I zgjerueshëm
+
+→ I zgjerueshëm ←
Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped
in and pulled out. For example, a teacher can drop in a collection of
animal shapes and ask their students to draw an ecosystem. Each shape can
have a sound which is played, and textual facts which are displayed, when
the child selects the shape.
-
-Bartje Në Platforma të Tjera
+
+→ Bartje Në Platforma të Tjera ←
Tux Paint is portable among various computer platforms: Windows, Macintosh,
Linux, etc. The interface looks the same among them all. Tux Paint runs
suitably well on older systems, and can be built to run better on slow
systems.
-
-Thjeshtësi
+
+→ Thjeshtësi ←
There is no direct access to the computer's underlying intricacies. The
current image is kept when the program quits, and reappears when it is
restarted. Saving images requires no need to create filenames or use the
keyboard. Opening an image is done by selecting it from a collection of
thumbnails. Access to other files on the computer is restricted.
-
-Përdorim Nga Persona Me Aftësi të Kufizuara
+
+→ Përdorim Nga Persona Me Aftësi të Kufizuara ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
+
-
-C. Licencë
+ ### C. Licencë ###
Tux Paint is an Open Source project, Free Software released under the GNU
General Public License (GPL). It is free, and the 'source code' behind the
@@ -97,62 +97,76 @@ parts of the program in their own GPL'd software.)
See COPYING.txt for the full text of the GPL license.
-D. What's New in Tux Paint version 0.9.34?
+ ### D. What's New in Tux Paint version 0.9.34? ###
-"Eraser" Fill mode
+→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
-
-New brushes
+
+→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
-New brush option
+
+→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
-New templates
+
+→ New templates ←
"Clouds from an airplane" and "Lough Leane".
-New Magic tool: Comic dots
+
+→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
-
-New Magic tool: Rotate
+
+→ New Magic tool: Rotate ←
Rotates the drawing.
-
-New Magic tool: Fractal
+
+→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
-
-New Magic tool: ASCII Typewriter
+
+→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
-New Magic tool: ASCII Computer
+
+→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
-New Magic tool: ASCII Color Computer
+
+→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
-New Magic tool: Crescent
+
+→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
-New Magic tool: Spiral
+
+→ New Magic tool: Spiral ←
Draw spirals.
-New Magic tool: Spiral Square
+
+→ New Magic tool: Spiral Square ←
Draw square spirals.
-New Magic tool: Concentric Circle
+
+→ New Magic tool: Concentric Circle ←
Draw concentric circles.
-New Magic tool: Concentric Square
+
+→ New Magic tool: Concentric Square ←
Draw concentric squares.
-New Magic tool: Tessellation Pointy
+
+→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
-New Magic tool: Tessellation Flat
+
+→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
-Magic API Updates
+
+→ Magic API Updates ←
Sound pause and resume functions added.
+
Për listën e plotë të ndryshimeve, shihni CHANGES.txt.
II. Përdorim i Tux Paint-it
-A. Nisja e Tux Paint-it
+ ### A. Nisja e Tux Paint-it ###
-1. Përdorues të Linux-it/Unix-it
+## 1. Përdorues të Linux-it/Unix-it ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@@ -163,7 +177,7 @@ Alternatively, you can run the following command at a shell prompt (e.g., "$"):
If any errors occur, they will be displayed on the terminal (to STDERR).
-2. Përdorues Windows-i
+## 2. Përdorues Windows-i ##
[Ikonë Tux Paint-i]
Tux Paint
@@ -187,13 +201,14 @@ installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
-3. Përdorues të MacOS-it
+## 3. Përdorues të MacOS-it ##
Thjesht dyklikoni mbi ikonën “Tux Paint”.
[Title screen]
+
-B. Title Screen
+ ### B. Title Screen ###
When Tux Paint first loads, a title/credits screen will appear.
@@ -201,20 +216,22 @@ Once loading is complete, press a key or click or tap in the Tux Paint window
to continue. (Or, after about 5 seconds, the title screen will go away
automatically.)
-C. Skena Kryesore
+ ### C. Skena Kryesore ###
The main screen is divided into the following sections:
[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser,
New, Open, Save, Print, Quit]
-Në Anën e Majtë: Panle
+
+→ Në Anën e Majtë: Panle ←
The toolbar contains the drawing and editing controls.
-
+
[Kanavacë]
-Në Mes: Kanavacë Vizatimi
+
+→ Në Mes: Kanavacë Vizatimi ←
The largest part of the screen, in the center, is the drawing canvas. This
is, obviously, where you draw!
@@ -225,9 +242,10 @@ Në Mes: Kanavacë Vizatimi
more details.
-
+
[Selectors - Brushes, Letters, Shapes, Stamps]
-Në Anën e Djathtë: Përzgjedhës
+
+→ Në Anën e Djathtë: Përzgjedhës ←
Depending on the current tool, the selector shows different things. e.g.,
when the Paint Brush or Line tool is selected, it shows the various brushes
@@ -236,10 +254,11 @@ Në Anën e Djathtë: Përzgjedhës
various fonts.
-
+
[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue,
Purple, Brown, Grey]
-Më Poshtë: Ngjyra
+
+→ Më Poshtë: Ngjyra ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@@ -295,23 +314,24 @@ Më Poshtë: Ngjyra
documentation.
-
+
(Shembull ndihmëze: “Zgjidhni një formë. Klikoni që të zgjidhni qendrën,
tërhiqeni, mandej lëreni, kur të ketë madhësinë që doni. Lëvizni përreth që
ta rrotulloni dhe klikoni që të vizatohet.”)
-Në Fund: Zonë Ndihme
+
+→ Në Fund: Zonë Ndihme ←
At the very bottom of the screen, Tux, the Linux Penguin, provides tips and
other information while you use Tux Paint.
+
+ ### D. Mjete të Mundshme ###
-D. Mjete të Mundshme
+## 1. Mjete Vizatimi ##
-1. Mjete Vizatimi
-
-a. Mjeti “Ngjyrosni” (Penel)
+a. Mjeti “Ngjyrosni” (Penel) ←
The Paint Brush tool lets you draw freehand, using various brushes (chosen
in the Selector on the right) and colors (chosen in the Color palette
@@ -353,8 +373,8 @@ a. Mjeti “Ngjyrosni” (Penel)
the brush spacing controls. See the "Options" documentation.
-
-b.Mjeti “Stampë” (Vula Gome)
+
+b.Mjeti “Stampë” (Vula Gome) ←
The Stamp tool is like a set of rubber stamps or stickers. It lets you
paste pre-drawn or photographic images (like a picture of a horse, or a
@@ -364,12 +384,12 @@ b.Mjeti “Stampë” (Vula Gome)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
- Kategori Stampash
+ → Kategori Stampash ←
There can be numerous categories of stamps (e.g., animals, plants,
outer space, vehicles, people, etc.). Use the Left and Right arrows
near the bottom of the Selector to cycle through the collections.
-
- Rrotullim Stampash
+
+ → Rrotullim Stampash ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@@ -386,8 +406,8 @@ b.Mjeti “Stampë” (Vula Gome)
0.9.29.
-
- Kontrolle Stampe
+
+ → Kontrolle Stampe ←
Prior to 'stamping' an image onto your drawing, various effects can
sometimes be applied (depending on the stamp):
@@ -406,8 +426,8 @@ b.Mjeti “Stampë” (Vula Gome)
Options" documentation.
-
- Tinguj Stampe
+
+ → Tinguj Stampe ←
Different stamps can have different sound effects and/or descriptive
(spoken) sounds. Buttons in the Help Area at the lower left (near Tux,
@@ -415,11 +435,11 @@ b.Mjeti “Stampë” (Vula Gome)
descriptive sounds for the currently-selected stamp.
+
-
-
-c.Mjeti “Vija”
+
+c.Mjeti “Vija” ←
This tool lets you draw straight lines using the various brushes and colors
you normally use with the Paint Brush.
@@ -444,8 +464,8 @@ c.Mjeti “Vija”
to learn more.
-
-d.Mjeti “Forma”
+
+d.Mjeti “Forma” ←
This tool lets you draw some simple filled, and un-filled shapes.
@@ -453,15 +473,15 @@ d.Mjeti “Forma”
Use the options at the bottom right to choose the shape tool's behavior:
- Forma që nga qendra
+ → Forma që nga qendra ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
-
- Forma që nga cepi
+
+ → Forma që nga cepi ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@@ -469,7 +489,7 @@ d.Mjeti “Forma”
📜 This option was added starting with Tux Paint version 0.9.25.
-
+
⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols"
option), the controls will not be presented, and the "shapes from center"
@@ -487,7 +507,7 @@ d.Mjeti “Forma”
Let go of the mouse when you're done stretching.
- Mënyra Forma Normale
+ → Mënyra Forma Normale ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@@ -497,8 +517,8 @@ d.Mjeti “Forma”
color.
-
- Mënyra Forma të Thjeshta
+
+ → Mënyra Forma të Thjeshta ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@@ -507,11 +527,11 @@ d.Mjeti “Forma”
thjeshta" ("simpleshapes") option.
+
-
-
-e.Mjete “Tekst” dhe “Etiketa”
+
+e.Mjete “Tekst” dhe “Etiketa” ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@@ -532,7 +552,7 @@ e.Mjete “Tekst” dhe “Etiketa”
causes the current line of text to move to that location (where you can
continue editing it).
- “Tekst” krahasuar me “Etiketë”
+ → “Tekst” krahasuar me “Etiketë” ←
The Text tool is the original text-entry tool in Tux Paint. Text
entered using this tool can't be modified or moved later, since it
@@ -567,8 +587,8 @@ e.Mjete “Tekst” dhe “Etiketa”
option).
-
- Futje Shenjash Ndërkombëtare
+
+ → Futje Shenjash Ndërkombëtare ←
Tux Paint allows inputting characters in different languages. Most
Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some
@@ -595,8 +615,8 @@ e.Mjete “Tekst” dhe “Etiketa”
trying to type.
-
- Tastierë Në Ekran
+
+ → Tastierë Në Ekran ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@@ -606,11 +626,11 @@ e.Mjete “Tekst” dhe “Etiketa”
information.
+
-
-
-f.Mjeti “Mbushje”
+
+f.Mjeti “Mbushje” ←
The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a
color of your choice. Three fill options are offered:
@@ -633,8 +653,8 @@ f.Mjeti “Mbushje”
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
-
-g.Mjeti “Magjik” (Efekte Speciale)
+
+g.Mjeti “Magjik” (Efekte Speciale) ←
The Magic tool is actually a set of special tools. Select one of the
'magic' effects from the selector on the right. Then, depending on the
@@ -684,8 +704,8 @@ g.Mjeti “Magjik” (Efekte Speciale)
one large list. See the "Options" documentation.
-
-h.Mjeti “Gomë”
+
+h.Mjeti “Gomë” ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@@ -717,11 +737,11 @@ h.Mjeti “Gomë”
currently-selected tool.
+
+## 2. Kontrolle të Tjera ##
-2. Kontrolle të Tjera
-
-a.Urdhrat “Ribëje” dhe “Zhbëje”
+a.Urdhrat “Ribëje” dhe “Zhbëje” ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@@ -739,8 +759,8 @@ a.Urdhrat “Ribëje” dhe “Zhbëje”
Ribëje.
-
-b.Urdhri “I ri”
+
+b.Urdhri “I ri” ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@@ -754,14 +774,14 @@ b.Urdhri “I ri”
⌨ Note: You can also press [Tasti Kontroll / ⌘] + [N] on the keyboard to
filloni një vizatim i ri.
- Special Solid Background Color Choices
+ → Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Skena Kryesore > Më Poshtë: Ngjyra > Special color
options for details.
-
- Figura “Fillesë” & Gjedhe
+
+ Figura “Fillesë” & Gjedhe ←
o 'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color in,
and the black outline remains intact — or like a 3D photograph,
@@ -791,8 +811,8 @@ b.Urdhri “I ri”
within Tux Paint, from the 'Open' dialog. See "Open", below.
-
- Fshirje Figurash Gjedhe të Eksportuara
+
+ → Fshirje Figurash Gjedhe të Eksportuara ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@@ -808,14 +828,14 @@ b.Urdhri “I ri”
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
-
+
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
-
-c.Urdhri “Hape”
+
+c.Urdhri “Hape” ←
This shows you a list of all of the pictures you've saved. If there are
more than can fit on the screen, use the up and down arrows at the top and
@@ -868,8 +888,8 @@ c.Urdhri “Hape”
hapni dialogun “Hap”.
-
-d.Urdhri “Ruaje”
+
+d.Urdhri “Ruaje” ←
Kjo bën ruajtjen e fotos tuaj të tanishme.
@@ -890,8 +910,8 @@ d.Urdhri “Ruaje”
save.
-
-e.Urdhri “Shtype”
+
+e.Urdhri “Shtype” ←
Klikoni këtë buton dhe fotoja juaj do të shtypet!
@@ -900,7 +920,7 @@ e.Urdhri “Shtype”
this may not work if you're running Tux Paint in fullscreen mode. See
below.
- Çaktivizim Shtypjesh
+ → Çaktivizim Shtypjesh ←
The "noprint" option can be set, which will disable Tux Paint's 'Print'
button.
@@ -908,8 +928,8 @@ e.Urdhri “Shtype”
⚙ See the "Options" documentation.
-
- Kufizim Shtypjesh
+
+ → Kufizim Shtypjesh ←
The "printdelay" option can be set, which will only allow occasional
printing — once every so many seconds, as configured by you.
@@ -920,8 +940,8 @@ e.Urdhri “Shtype”
⚙ See the "Options" documentation.
-
- Urdhra Shtypjeje
+
+ → Urdhra Shtypjeje ←
(Vetëm në Linux dhe Unix)
@@ -947,8 +967,8 @@ e.Urdhri “Shtype”
⚙ See the "Options" documentation.
-
- Rregullime Shtypësi
+
+ → Rregullime Shtypësi ←
(Windows dhe macOS)
@@ -970,8 +990,8 @@ e.Urdhri “Shtype”
⚙ See the "Options" documentation.
-
- Mundësi Dialogu Shtypësi
+
+ → Mundësi Dialogu Shtypësi ←
By default, Tux Paint only shows the printer dialog (or, on Linux/Unix,
runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the
@@ -986,17 +1006,17 @@ e.Urdhri “Shtype”
⚙ See the "Options" documentation.
+
-
-
-f.Urdhri “Diapozitiva” (nën “Hape”)
+
+f.Urdhri “Diapozitiva” (nën “Hape”) ←
The 'Slides' button is available in the 'Open' dialog. It can be used to
play a simple animation within Tux Paint, or a slideshow of pictures. It
can also export an animated GIF based on the chosen images.
- Zgjedhje fotosh
+ → Zgjedhje fotosh ←
When you enter the 'Slides' section of Tux Paint, it displays a list of
your saved files, just like the 'Open' dialog.
@@ -1010,8 +1030,8 @@ f.Urdhri “Diapozitiva” (nën “Hape”)
list.
-
- Caktoni shpejtësi luajtjeje
+
+ → Caktoni shpejtësi luajtjeje ←
A sliding scale at the lower left of the screen (next to the 'Play'
button) can be used to adjust the speed of the slideshow or animated
@@ -1024,8 +1044,8 @@ f.Urdhri “Diapozitiva” (nën “Hape”)
does not apply to an exported animated GIF.)
-
- Luajtje në Tux Paint
+
+ → Luajtje në Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@@ -1041,8 +1061,8 @@ f.Urdhri “Diapozitiva” (nën “Hape”)
exit the slideshow and return to the slideshow image selection screen.
-
- Eksportim i një Gif-i të animuar
+
+ → Eksportim i një Gif-i të animuar ←
Click the 'GIF Export' button near the lower right to have Tux Paint
generate an animated GIF file based on the selected images.
@@ -1056,14 +1076,14 @@ f.Urdhri “Diapozitiva” (nën “Hape”)
process, and return you to the 'Slideshow' dialog.
-
+
Click 'Back' in the slideshow image selection screen to return to the
'Open' dialog.
-
-g.Urdhëri “Dil”
+
+g.Urdhëri “Dil” ←
Clicking the 'Quit' button, closing the Tux Paint window, or pushing the
[Tasti Escape] key will quit Tux Paint.
@@ -1090,8 +1110,8 @@ g.Urdhëri “Dil”
⚙ See the "Options" documentation.
-
-h.Heqje Tingujsh
+
+h.Heqje Tingujsh ←
There is no on-screen control button at this time, but by using the [Alt] +
[S] keyboard sequence, sound effects can be disabled and re-enabled (muted
@@ -1104,11 +1124,11 @@ h.Heqje Tingujsh
⚙ See the "Options" documentation.
+
+ ### E. Kontrollim i Tux Paint-it ###
-E. Kontrollim i Tux Paint-it
-
-1. Përdorim i një Miu ose Trackball-i
+## 1. Përdorim i një Miu ose Trackball-i ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@@ -1124,7 +1144,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
-a. Rrëshqitje
+# a. Rrëshqitje #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@@ -1137,7 +1157,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
-b. Përdorim Miu Nga Persona Me Aftësi të Kufizuar
+# b. Përdorim Miu Nga Persona Me Aftësi të Kufizuar #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@@ -1150,7 +1170,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
-2. Përdorim i një Tableti, ose Ekrani Me Prekje
+## 2. Përdorim i një Tableti, ose Ekrani Me Prekje ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@@ -1162,7 +1182,7 @@ Some examples:
* Majë gome
* Gjeste multi-touch
-3. Përdorimi i një Pajisjeje të Ngashme me një “Joystick”
+## 3. Përdorimi i një Pajisjeje të Ngashme me një “Joystick” ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@@ -1176,7 +1196,7 @@ to different Tux Paint controls (e.g., acting as the [Tasti Escape] key,
switching to the Paint tool, invoking Undo and Redo operations, etc.). See the
Options documentation for more details.
-4. Përdorim i Tastierës
+## 4. Përdorim i Tastierës ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@@ -1185,7 +1205,7 @@ documentation for more details.
III. Ngarkim Figurash të Tjera në Tux Paint
-A. Përmbledhje
+ ### A. Përmbledhje ###
Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So
what do you do if you want to load some other drawinng or even a photograph
@@ -1195,29 +1215,29 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
-Windows Windows 7, Windows 8, Windows 10, Windows 11
+→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\"
-
-macOS
+
+→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/"
-
-Linux / Unix
+
+→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/emër përdoruesi/.tuxpaint/saved/"
-
-Haiku
+
+→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
-
+
💡 Note: It is also from this folder that you can copy or open pictures drawn in
Tux Paint using other applications, though the 'Export' option from Tux Paint's
'Open' dialog can be used to copy them to a location that's easier and safer to
access.
-B. Përdorim i programthit të importimit, “tuxpaint-import”
+ ### B. Përdorim i programthit të importimit, “tuxpaint-import” ###
Linux and Unix users can use the "tuxpaint-import" shell script which gets
installed when you install Tux Paint. It uses some NetPBM tools to convert the
@@ -1248,7 +1268,7 @@ following two lines are output from the program while it's working.
Now you can load Tux Paint, and a version of that original picture will be
available under the 'Open' dialog. Just double-click its icon!
-C. Importim Fotosh Dorazi
+ ### C. Importim Fotosh Dorazi ###
Windows, macOS, and Haiku users who wish to import arbitrary images into Tux
Paint must do so via a manual process.
@@ -1266,7 +1286,7 @@ Paint's canvas size. This size depends on the size of the Tux Paint window, or
resolution at which Tux Paint is run, if in fullscreen. (Note: The default
resolution is 800x600.) See "Llogaritje Përmasash Figure", below.
-1. Emërtim i Kartelës
+## 1. Emërtim i Kartelës ##
Save the picture in PNG format. It is highly recommended that you name the
filename using the current date and time, since that's the convention Tux Paint
@@ -1285,7 +1305,7 @@ Example: "20210731110500.png", for July 31, 2021 at 11:05am.
Place this PNG file in your Tux Paint "saved" directory/folder. (See above.)
-2. Llogaritje Përmasash Figure
+## 2. Llogaritje Përmasash Figure ##
This part of the documentation needs to be rewritten, since the new
"buttonsize" option was added. For now, try drawing and saving an image within
@@ -1298,7 +1318,7 @@ IV.Lexim i Mëtejshëm
Other documentation included with Tux Paint (found in the "docs" folder/
directory) includes:
-Përdorim i Tux Paint-it:
+→ Përdorim i Tux Paint-it: ←
+ OPTIONS.html
Detailed instructions on command-line and configuration-file options,
for those who don't want to use the Tux Paint Config. tool to manage
@@ -1309,8 +1329,8 @@ Përdorim i Tux Paint-it:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
-
-Si të zgjerohet Tux Paint-i:
+
+→ Si të zgjerohet Tux Paint-i: ←
+ EXTENDING.html
Detailed instructions on extending Tux Paint: creating brushes, stamps,
starters, and templates; adding fonts; and creating new on-screen
@@ -1321,8 +1341,8 @@ Si të zgjerohet Tux Paint-i:
+ SVG.html
Notes on creating SVG format vector images for use in Tux Paint.
-
-Hollësi teknike:
+
+→ Hollësi teknike: ←
+ INSTALL.html
Instructions for compiling and installing Tux Paint, when applicable.
+ SIGNALS.html
@@ -1330,8 +1350,8 @@ Hollësi teknike:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
-
-Historik zhvillimi dhe licencë:
+
+→ Historik zhvillimi dhe licencë: ←
+ AUTHORS.txt
Listë e autorëve dhe kontribuesve.
+ CHANGES.txt
@@ -1339,7 +1359,7 @@ Historik zhvillimi dhe licencë:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
-
+
V.Si të Merret Ndihmë
diff --git a/docs/sq_AL.UTF-8/SIGNALS.txt b/docs/sq_AL.UTF-8/SIGNALS.txt
index 39f55ab95..4f6ef42d0 100644
--- a/docs/sq_AL.UTF-8/SIGNALS.txt
+++ b/docs/sq_AL.UTF-8/SIGNALS.txt
@@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
-SIGTERM (also, [Tasti Kontroll] + [C] from a terminal running `tuxpaint`)
+→ SIGTERM (also, [Tasti Kontroll] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@@ -32,8 +32,8 @@ SIGTERM (also, [Tasti Kontroll] + [C] from a terminal running `tuxpaint`)
the [Tasti Esc] was key pressed.
-
-SIGUSR1 & SIGUSR2
+
+→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.
-
+
diff --git a/docs/sq_AL.UTF-8/SVG.txt b/docs/sq_AL.UTF-8/SVG.txt
index bd022a131..c6eb7a65d 100644
--- a/docs/sq_AL.UTF-8/SVG.txt
+++ b/docs/sq_AL.UTF-8/SVG.txt
@@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
-Burim i Hapët
+→ Burim i Hapët ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
-
-Pronësor
+
+→ Pronësor ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/
diff --git a/docs/sq_AL.UTF-8/html/EXTENDING.html b/docs/sq_AL.UTF-8/html/EXTENDING.html
index afc261830..4f1a9b924 100644
--- a/docs/sq_AL.UTF-8/html/EXTENDING.html
+++ b/docs/sq_AL.UTF-8/html/EXTENDING.html
@@ -871,6 +871,7 @@
alt="[ Figurë e formuar si peizazh i një horizonti me diellin në mes dhe një ndërtesë në të djathtë. ]"
title="Figurë e formuar si peizazh i një horizonti me diellin në mes dhe një ndërtesë në të djathtë."
valign="middle" />
+
Focusing on the në qendër of a starter image stretched to fit the gjerësia of the canvas.
@@ -884,6 +885,7 @@
alt="[ Figurë e formuar si portret e një horizonti me diellin në mes dhe anën e majtë të një ndërtese në të djathtë. ]"
title="Figurë e formuar si portret e një horizonti me diellin në mes dhe anën e majtë të një ndërtese në të djathtë."
valign="middle" />
+
Focusing on the në qendër of a starter image stretched to fit the lartësia of the canvas.
@@ -897,6 +899,7 @@
alt="[ Figurë e formuar si peizazh e qiellit me diellin poshtë dhe majën e një ndërtese në të djathtë. ]"
title="Figurë e formuar si peizazh e qiellit me diellin poshtë dhe majën e një ndërtese në të djathtë."
valign="middle" />
+
Focusing on the në krye of a starter image stretched to fit the gjerësia of the canvas.
@@ -910,6 +913,7 @@
alt="[ Figurë e formuar si peizazh e truallit me diellin në krye. ]"
title="Figurë e formuar si peizazh e truallit me diellin në krye."
valign="middle" />
+
Focusing on the në fund of a starter image stretched to fit the gjerësia of the canvas.
@@ -923,6 +927,7 @@
alt="[ Figurë e formuar si portret e një horizonti me diellin në të majtë dhe një ndërtesë në qendër. ]"
title="Figurë e formuar si portret e një horizonti me diellin në të majtë dhe një ndërtesë në qendër."
valign="middle" />
+
Focusing on the djathtas of a starter image stretched to fit the lartësia of the canvas.
diff --git a/docs/sq_AL.UTF-8/html/README.html b/docs/sq_AL.UTF-8/html/README.html
index 8bbf5ebfe..4c4db8667 100644
--- a/docs/sq_AL.UTF-8/html/README.html
+++ b/docs/sq_AL.UTF-8/html/README.html
@@ -102,7 +102,7 @@
- 12 tetor 2024
+ 14 tetor 2024
A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.
- New brushes
- - New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
+
- New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".
- New brush option
- - Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
+
- Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.
- New templates
- - "Clouds from an airplane" and "Lough Leane".
+
- "Clouds from an airplane" and "Lough Leane".
- New Magic tool: Comic dots
- Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.
@@ -250,37 +250,37 @@
- A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.
- New Magic tool: ASCII Typewriter
- - Transform your picture into "ASCII art", typewriter-style.
+
- Transform your picture into "ASCII art", typewriter-style.
- New Magic tool: ASCII Computer
- - Transform your picture into "ASCII art", computer-style.
+
- Transform your picture into "ASCII art", computer-style.
- New Magic tool: ASCII Color Computer
- - Transform your picture into colored computer "ASCII art".
+
- Transform your picture into colored computer "ASCII art".
- New Magic tool: Crescent
- - Draw one of various crescent shapes at a chosen angle.
+
- Draw one of various crescent shapes at a chosen angle.
- New Magic tool: Spiral
- - Draw spirals.
+
- Draw spirals.
- New Magic tool: Spiral Square
- - Draw square spirals.
+
- Draw square spirals.
- New Magic tool: Concentric Circle
- - Draw concentric circles.
+
- Draw concentric circles.
- New Magic tool: Concentric Square
- - Draw concentric squares.
+
- Draw concentric squares.
- New Magic tool: Tessellation Pointy
- - Draw repeating tessellation patterns with pointy-topped hexagons.
+
- Draw repeating tessellation patterns with pointy-topped hexagons.
- New Magic tool: Tessellation Flat
- - Draw repeating tessellation patterns with flat-topped hexagons.
+
- Draw repeating tessellation patterns with flat-topped hexagons.
- Magic API Updates
- - Sound pause and resume functions added.
+
- Sound pause and resume functions added.
@@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Title screen]">
+
B. Title Screen
@@ -412,6 +413,7 @@
height="254"
alt=
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]">
+
-
Në Anën e Majtë: Panle
@@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Kanavacë]">
+
-
@@ -455,6 +458,7 @@
height="254"
alt=
"[Selectors - Brushes, Letters, Shapes, Stamps]">
+
-
@@ -476,6 +480,7 @@
height="254"
alt=
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
+
-
@@ -486,13 +491,14 @@
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.)
-
+
+

+
-
On the far right are three special color options:
-
@@ -544,6 +550,7 @@
height="254"
alt=
"(Shembull ndihmëze: “Zgjidhni një formë. Klikoni që të zgjidhni qendrën, tërhiqeni, mandej lëreni, kur të ketë madhësinë që doni. Lëvizni përreth që ta rrotulloni dhe klikoni që të vizatohet.”)">
+
-
diff --git a/docs/sq_AL.UTF-8/tuxpaint-quickstart-guide.txt b/docs/sq_AL.UTF-8/tuxpaint-quickstart-guide.txt
index 3ebddf525..b60957242 100644
--- a/docs/sq_AL.UTF-8/tuxpaint-quickstart-guide.txt
+++ b/docs/sq_AL.UTF-8/tuxpaint-quickstart-guide.txt
@@ -1,8 +1,8 @@
Udhërrëfyes Fillimi të Shpejtë për Tux Paint 0.9.34
-Mjete (Vizatim)
+ ### Mjete (Vizatim) ###
-🖌Bojë
+## 🖌Bojë ##
* Zgjidhni djathtas një penel.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@@ -10,7 +10,7 @@ Mjete (Vizatim)
* Zgjidhni një ngjyrën (shihni “Ngjyra”).
* Klikoni/prekeni dhe tërhiqeni nëpër kanavacë që të ngjyroset.
-⌧Stampa
+## ⌧Stampa ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Zgjidhni djathtas një stampë.
@@ -27,12 +27,12 @@ Mjete (Vizatim)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
-⚟Vija
+## ⚟Vija ##
* (Shihni Pikturë)
* Klikomo/prekeni dhe tërhiqeni që të vizatohet një vijë.
-⭓Forma
+## ⭓Forma ##
* Zgjidhni djathtas një formë.
* Select whether you want to extend the shape from the center ⧈, or a corner
@@ -40,7 +40,7 @@ Mjete (Vizatim)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
-🄰Tekst
+## 🄰Tekst ##
* Zgjidhni djathtas shkronja.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@@ -60,7 +60,7 @@ Mjete (Vizatim)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
-🅰Etiketë
+## 🅰Etiketë ##
* (Shihni Tekst)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@@ -74,7 +74,7 @@ Mjete (Vizatim)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
-🪣Mbushje
+## 🪣Mbushje ##
* Zgjidhni djathtas një mënyrë mbushjeje.
* Zgjidhni një ngjyrën (shihni “Ngjyra”).
@@ -90,7 +90,7 @@ Mjete (Vizatim)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
-🪄Magjik
+## 🪄Magjik ##
* Zgjidhni djathtas një mjet magjik.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@@ -101,26 +101,26 @@ Mjete (Vizatim)
bottom right.
* Some magic tools allow you to choose their color.
-🖓Zhbëje
+## 🖓Zhbëje ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
-🖒Ribëje
+## 🖒Ribëje ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
-◪Gomë
+## ◪Gomë ##
* Zgjidhni djathtas madhësinë dhe formën e gomës.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
-Mjete (Kontrolle)
+ ### Mjete (Kontrolle) ###
-🗏I ri
+## 🗏I ri ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@@ -131,7 +131,7 @@ Mjete (Kontrolle)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
-🕮⮫Hapni
+## 🕮⮫Hapni ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@@ -150,7 +150,7 @@ Mjete (Kontrolle)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
-🕮⮪Ruaje
+## 🕮⮪Ruaje ##
* Klikoni/prekeni, që vizatimi juaj të ruhet.
* If you've saved previously, you'll be prompted whether to overwrite the
@@ -158,19 +158,19 @@ Mjete (Kontrolle)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
-🖶Shtype
+## 🖶Shtype ##
* Klikoni/prekeni që vizatimi juaj të shtypet.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
-🗙Mbylle
+## 🗙Mbylle ##
* Klikoni/prekeni, që Tux Paint-i të mbyllet.
* Shortcut: [Escape]
-Ngjyra
+ ### Ngjyra ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@@ -194,7 +194,7 @@ Ngjyra
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
-Shkurtore, teksa vizatohet:
+ ### Shkurtore, teksa vizatohet: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access
diff --git a/docs/w3m.sh b/docs/w3m.sh
index 552331256..2623f5409 100755
--- a/docs/w3m.sh
+++ b/docs/w3m.sh
@@ -3,16 +3,49 @@
infile=${@: -1}
args=${@:1:${#}-1}
+# Add some visual indicators around some text
+# to make their context -- heading ("
", ""), etc -- more obvious in
+# the plain text version of the documentation:
+
+H2_OPEN_MUNGE="s/]*\)>/### /"
+H2_CLOSE_MUNGE="s/<\/h2>/ ###<\/center><\/h2>/"
+H3_OPEN_MUNGE="s/]*\)>/## /"
+H3_CLOSE_MUNGE="s/<\/h3>/ ##<\/h3>/"
+H4_OPEN_MUNGE="s/]*\)>/# /"
+H4_CLOSE_MUNGE="s/<\/h4>/ #<\/h4>/"
+DT_OPEN_MUNGE="s/- /
- \→ /"
+DT_CLOSE_MUNGE="s/<\/dt>/ \←<\/dt>/"
+DD_CLOSE_MUNGE="s/<\/dd>/
\
<\/dd>/"
+
# FIXME: https://en.wikipedia.org/wiki/Line_breaking_rules_in_East_Asian_languages
# | sed -e "s/\(.[、。)]\)/\\1<\\/nobr>/g" \
# This needs expanding & to not mess with
`alt` tag attributes or anything inside HTML tags (e.g., " quotes)!
# -bjk 2023.07.17
if [[ "$infile" =~ ja_JP ]]; then
- sed -e "s/<\\/dd>/
<\\/dd>/g" $infile \
+ sed $infile \
+ -e "$H2_OPEN_MUNGE" \
+ -e "$H2_CLOSE_MUNGE" \
+ -e "$H3_OPEN_MUNGE" \
+ -e "$H3_CLOSE_MUNGE" \
+ -e "$H4_OPEN_MUNGE" \
+ -e "$H4_CLOSE_MUNGE" \
+ -e "$DT_OPEN_MUNGE" \
+ -e "$DT_CLOSE_MUNGE" \
+ -e "$DD_CLOSE_MUNGE" \
| php ./nobr_forbidden.php \
| w3m $args
else
- sed -e "s/<\\/dd>/
<\\/dd>/g" $infile \
+ sed $infile \
+ -e "$H2_OPEN_MUNGE" \
+ -e "$H2_CLOSE_MUNGE" \
+ -e "$H3_OPEN_MUNGE" \
+ -e "$H3_CLOSE_MUNGE" \
+ -e "$H4_OPEN_MUNGE" \
+ -e "$H4_CLOSE_MUNGE" \
+ -e "$DT_OPEN_MUNGE" \
+ -e "$DT_CLOSE_MUNGE" \
+ -e "$DD_CLOSE_MUNGE" \
| w3m $args
fi
diff --git a/magic/magic-docs/en/1pt_perspective.txt b/magic/magic-docs/en/1pt_perspective.txt
index e9201da6c..aa2531ea2 100644
--- a/magic/magic-docs/en/1pt_perspective.txt
+++ b/magic/magic-docs/en/1pt_perspective.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 1-Point Draw
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw with 1-point perspective. Lines will only go towards
your vanishing point, or be horizontal or vertical. Use "1-Point Select" to
diff --git a/magic/magic-docs/en/1pt_perspective_select.txt b/magic/magic-docs/en/1pt_perspective_select.txt
index a12ec587d..6bc150543 100644
--- a/magic/magic-docs/en/1pt_perspective_select.txt
+++ b/magic/magic-docs/en/1pt_perspective_select.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 1-Point Select
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click (and drag) to position the vanishing point that will be used with the
"1-Point Draw" tool.
diff --git a/magic/magic-docs/en/2pt_perspective.txt b/magic/magic-docs/en/2pt_perspective.txt
index 29515c5f1..fb8e450ad 100644
--- a/magic/magic-docs/en/2pt_perspective.txt
+++ b/magic/magic-docs/en/2pt_perspective.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 2-Point Draw
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw with 2-point perspective. Lines will only go towards
your two vanishing points, or aligned with either the "horizon" defined by the
diff --git a/magic/magic-docs/en/2pt_perspective_select.txt b/magic/magic-docs/en/2pt_perspective_select.txt
index e4a5fc29b..6d68cd20e 100644
--- a/magic/magic-docs/en/2pt_perspective_select.txt
+++ b/magic/magic-docs/en/2pt_perspective_select.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 2-Point Select
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click (and drag) to position the two vanishing points that will be used with
the "2-Point Draw" tool.
diff --git a/magic/magic-docs/en/3dglasses.txt b/magic/magic-docs/en/3dglasses.txt
index 166d485a4..7175b734f 100644
--- a/magic/magic-docs/en/3dglasses.txt
+++ b/magic/magic-docs/en/3dglasses.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 3D Glasses
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This tool horizontally separates your entire picture's color channels, letting
you create anaglyphic pictures that can be viewed with various kinds of 3D
diff --git a/magic/magic-docs/en/3pt_perspective.txt b/magic/magic-docs/en/3pt_perspective.txt
index 87a1ff709..0542f7af1 100644
--- a/magic/magic-docs/en/3pt_perspective.txt
+++ b/magic/magic-docs/en/3pt_perspective.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 3-Point Draw
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw with 3-point perspective. Lines will only go towards
your three vanishing points, or aligned with the "horizon" defined by two of
diff --git a/magic/magic-docs/en/3pt_perspective_select.txt b/magic/magic-docs/en/3pt_perspective_select.txt
index c1daf6866..f32678b4e 100644
--- a/magic/magic-docs/en/3pt_perspective_select.txt
+++ b/magic/magic-docs/en/3pt_perspective_select.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: 3-Point Select
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click (and drag) to position the three vanishing points that will be used with
the "3-Point Draw" tool.
diff --git a/magic/magic-docs/en/ascii_color_computer.txt b/magic/magic-docs/en/ascii_color_computer.txt
index 4504bc2ce..7e9c7bea5 100644
--- a/magic/magic-docs/en/ascii_color_computer.txt
+++ b/magic/magic-docs/en/ascii_color_computer.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: ASCII Color Computer
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Transform your picture into colored computer "ASCII art".
diff --git a/magic/magic-docs/en/ascii_computer.txt b/magic/magic-docs/en/ascii_computer.txt
index b86a6f726..4fa183b0f 100644
--- a/magic/magic-docs/en/ascii_computer.txt
+++ b/magic/magic-docs/en/ascii_computer.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: ASCII Computer
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Transform your picture into "ASCII art", computer-style.
diff --git a/magic/magic-docs/en/ascii_typewriter.txt b/magic/magic-docs/en/ascii_typewriter.txt
index aefecc65e..4983735d9 100644
--- a/magic/magic-docs/en/ascii_typewriter.txt
+++ b/magic/magic-docs/en/ascii_typewriter.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: ASCII Typewriter
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Transform your picture into "ASCII art", typewriter-style.
diff --git a/magic/magic-docs/en/blinds.txt b/magic/magic-docs/en/blinds.txt
index de6109bd6..2cabb4d8d 100644
--- a/magic/magic-docs/en/blinds.txt
+++ b/magic/magic-docs/en/blinds.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Blind
- Group: Picture Decorations
+ ### Group: Picture Decorations ###
- Author: Pere Pujal i Carabantes
+ ## Author: Pere Pujal i Carabantes ##
Click towards the edge of your picture to pull window blinds over it. Move
perpendicularly to open or close the blinds.
diff --git a/magic/magic-docs/en/blocks.txt b/magic/magic-docs/en/blocks.txt
index b7bb3af05..679ada4f6 100644
--- a/magic/magic-docs/en/blocks.txt
+++ b/magic/magic-docs/en/blocks.txt
@@ -1,9 +1,10 @@
Tux Paint "Magic" Tool: Blocks
- Group: Distorts
+ ### Group: Distorts ###
- Authors: Bill Kendrick
+ ## Authors: Bill Kendrick
Albert Cahalan
+ ##
This makes the picture blocky looking ("pixelated") wherever you drag the
mouse.
diff --git a/magic/magic-docs/en/bloom.txt b/magic/magic-docs/en/bloom.txt
index 0f675dd3a..ceed5dac1 100644
--- a/magic/magic-docs/en/bloom.txt
+++ b/magic/magic-docs/en/bloom.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Bloom
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Add a glowing "bloom" effect to pictures.
diff --git a/magic/magic-docs/en/blur.txt b/magic/magic-docs/en/blur.txt
index 0b0e28264..e9561fd95 100644
--- a/magic/magic-docs/en/blur.txt
+++ b/magic/magic-docs/en/blur.txt
@@ -1,9 +1,10 @@
Tux Paint "Magic" Tool: Blur
- Group: Distorts
+ ### Group: Distorts ###
- Authors: Bill Kendrick
+ ## Authors: Bill Kendrick
Albert Cahalan
+ ##
This makes the picture fuzzy wherever you drag the mouse.
diff --git a/magic/magic-docs/en/bricks.txt b/magic/magic-docs/en/bricks.txt
index 074b21cbb..f28441450 100644
--- a/magic/magic-docs/en/bricks.txt
+++ b/magic/magic-docs/en/bricks.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Bricks
- Group: Painting
+ ### Group: Painting ###
- Author: Albert Cahalan
+ ## Author: Albert Cahalan ##
This tool intelligently paints brick patterns on the canvas. The bricks can be
tinted various redish hues by selecting different colors in the color palette.
diff --git a/magic/magic-docs/en/calligraphy.txt b/magic/magic-docs/en/calligraphy.txt
index 6bc4f092d..cafee8ad1 100644
--- a/magic/magic-docs/en/calligraphy.txt
+++ b/magic/magic-docs/en/calligraphy.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Calligraphy
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This paints on the canvas with a calligraphy pen. The quicker you move, the
thinner the lines.
diff --git a/magic/magic-docs/en/cartoon.txt b/magic/magic-docs/en/cartoon.txt
index 8b2a3f4ed..3def9bf5e 100644
--- a/magic/magic-docs/en/cartoon.txt
+++ b/magic/magic-docs/en/cartoon.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Cartoon
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes the picture look like a cartoon — with thick outlines and bright,
solid colors — wherever you move the mouse.
diff --git a/magic/magic-docs/en/chalk.txt b/magic/magic-docs/en/chalk.txt
index a6bb9e895..7360f45f8 100644
--- a/magic/magic-docs/en/chalk.txt
+++ b/magic/magic-docs/en/chalk.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Chalk
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes parts of the picture (where you move the mouse) look like a chalk
drawing.
diff --git a/magic/magic-docs/en/checkerboard.txt b/magic/magic-docs/en/checkerboard.txt
index 7c8146000..12b246f9a 100644
--- a/magic/magic-docs/en/checkerboard.txt
+++ b/magic/magic-docs/en/checkerboard.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Checkerboard
- Group: Picture Decorations
+ ### Group: Picture Decorations ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This covers the entire canvas with a checkboard pattern using the current
color. Drag to change the size of the squares.
diff --git a/magic/magic-docs/en/circles.txt b/magic/magic-docs/en/circles.txt
index 17ddb91f8..45e1a7bb0 100644
--- a/magic/magic-docs/en/circles.txt
+++ b/magic/magic-docs/en/circles.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Circles
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This transforms the picture into circular brush strokes around where you
clicked.
diff --git a/magic/magic-docs/en/clone.txt b/magic/magic-docs/en/clone.txt
index c8809fba6..883b79b5a 100644
--- a/magic/magic-docs/en/clone.txt
+++ b/magic/magic-docs/en/clone.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Clone
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Clone (copy, via painting) part of the picture. Click ones to choose the
source, then click and drag to clone it elsewhere in the drawing. Once you
diff --git a/magic/magic-docs/en/color_and_white.txt b/magic/magic-docs/en/color_and_white.txt
index 86909b45a..a8da1c826 100644
--- a/magic/magic-docs/en/color_and_white.txt
+++ b/magic/magic-docs/en/color_and_white.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Color and White
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Andrew Corcoran
+ ## Author: Andrew Corcoran ##
This makes parts of your picture two colors: white, and the color chosen in the
palette — i.e., if you choose black, you'll get a black and white picture; no
diff --git a/magic/magic-docs/en/color_shift.txt b/magic/magic-docs/en/color_shift.txt
index e7b58a39a..8bb47a7cd 100644
--- a/magic/magic-docs/en/color_shift.txt
+++ b/magic/magic-docs/en/color_shift.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Color Shift
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Andrew Corcoran
+ ## Author: Andrew Corcoran ##
This shifts the colors in your picture.
diff --git a/magic/magic-docs/en/colorsep.txt b/magic/magic-docs/en/colorsep.txt
index a6f5bedbc..88460da22 100644
--- a/magic/magic-docs/en/colorsep.txt
+++ b/magic/magic-docs/en/colorsep.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Color Sep.
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This tool separates one color out of your entire picture, shifting colors away
from each other (similar to '3D Glasses', but you may choose the any color to
diff --git a/magic/magic-docs/en/comic_dots.txt b/magic/magic-docs/en/comic_dots.txt
index 67568a165..b7cab62ce 100644
--- a/magic/magic-docs/en/comic_dots.txt
+++ b/magic/magic-docs/en/comic_dots.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Comic Dots
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draws a repeating dot pattern, simulating the "Ben Day process" used in early
comic books.
diff --git a/magic/magic-docs/en/concentric-circle.txt b/magic/magic-docs/en/concentric-circle.txt
index 2670ba798..4114b64d2 100644
--- a/magic/magic-docs/en/concentric-circle.txt
+++ b/magic/magic-docs/en/concentric-circle.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Concentric Circle
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draw concentric circles.
diff --git a/magic/magic-docs/en/concentric-square.txt b/magic/magic-docs/en/concentric-square.txt
index ab8ae154d..6d451d039 100644
--- a/magic/magic-docs/en/concentric-square.txt
+++ b/magic/magic-docs/en/concentric-square.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Concentric Square
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draw concentric squares.
diff --git a/magic/magic-docs/en/confetti.txt b/magic/magic-docs/en/confetti.txt
index 1bb978498..fd4585635 100644
--- a/magic/magic-docs/en/confetti.txt
+++ b/magic/magic-docs/en/confetti.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Confetti
- Group: Painting
+ ### Group: Painting ###
- Author: Adam Rakowski
+ ## Author: Adam Rakowski ##
Throw confetti around your picture!
diff --git a/magic/magic-docs/en/crescent.txt b/magic/magic-docs/en/crescent.txt
index 2dc628587..91e2cd88e 100644
--- a/magic/magic-docs/en/crescent.txt
+++ b/magic/magic-docs/en/crescent.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Crescent
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draw one of various crescent shapes at a chosen angle.
diff --git a/magic/magic-docs/en/darken.txt b/magic/magic-docs/en/darken.txt
index 49df2994c..a8afe817b 100644
--- a/magic/magic-docs/en/darken.txt
+++ b/magic/magic-docs/en/darken.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Darken
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This darkens the colors wherever you drag the mouse. (Do it to the same spot
many times, and it will eventually become black.)
diff --git a/magic/magic-docs/en/desaturate.txt b/magic/magic-docs/en/desaturate.txt
index ed4efaeab..47cc0ef16 100644
--- a/magic/magic-docs/en/desaturate.txt
+++ b/magic/magic-docs/en/desaturate.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Desaturate
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This desaturates the colors wherever you drag the mouse. (Do it to the same
spot many times, and it will eventually become greyscale.)
diff --git a/magic/magic-docs/en/dimetric_draw.txt b/magic/magic-docs/en/dimetric_draw.txt
index 0d397d9bc..512592124 100644
--- a/magic/magic-docs/en/dimetric_draw.txt
+++ b/magic/magic-docs/en/dimetric_draw.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Dimetric Draw
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw in a dimetric projection. Lines will only go vertically,
or at a chosen angle and its mirror. Use "Dimetric Select" to adjust the angle.
diff --git a/magic/magic-docs/en/dimetric_select.txt b/magic/magic-docs/en/dimetric_select.txt
index bb5adb985..62545fce0 100644
--- a/magic/magic-docs/en/dimetric_select.txt
+++ b/magic/magic-docs/en/dimetric_select.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Dimetric Select
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click (and drag) to position the pair of angles that will be used with the
"Dimetric Draw" tool.
diff --git a/magic/magic-docs/en/distortion.txt b/magic/magic-docs/en/distortion.txt
index e99774534..67235c692 100644
--- a/magic/magic-docs/en/distortion.txt
+++ b/magic/magic-docs/en/distortion.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Distortion
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This slightly distorts the picture wherever you move the mouse.
diff --git a/magic/magic-docs/en/dither.txt b/magic/magic-docs/en/dither.txt
index 9ea0675a8..572d414e8 100644
--- a/magic/magic-docs/en/dither.txt
+++ b/magic/magic-docs/en/dither.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Dither
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes parts of your picture two colors: white, and the color chosen in the
palette, using a dithered pattern of dots that reflect the original picture's
diff --git a/magic/magic-docs/en/dither_keep_colors.txt b/magic/magic-docs/en/dither_keep_colors.txt
index 54d087304..fbf7e72c0 100644
--- a/magic/magic-docs/en/dither_keep_colors.txt
+++ b/magic/magic-docs/en/dither_keep_colors.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Dither (Keep Colors)
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes parts of your picture two colors: white, and colors based on your
original drawing, using a dithered pattern of dots that reflect the original
diff --git a/magic/magic-docs/en/doublevision.txt b/magic/magic-docs/en/doublevision.txt
index 8724367ab..f924dd200 100644
--- a/magic/magic-docs/en/doublevision.txt
+++ b/magic/magic-docs/en/doublevision.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Double Vision
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This blends the image with itself, to simulate double vision.
diff --git a/magic/magic-docs/en/drip.txt b/magic/magic-docs/en/drip.txt
index a0b8509b6..1455be6bc 100644
--- a/magic/magic-docs/en/drip.txt
+++ b/magic/magic-docs/en/drip.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Drip
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes the paint "drip" wherever you move the mouse.
diff --git a/magic/magic-docs/en/edges.txt b/magic/magic-docs/en/edges.txt
index be1df65cf..e68245acb 100644
--- a/magic/magic-docs/en/edges.txt
+++ b/magic/magic-docs/en/edges.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Edges
- Group: Distorts
+ ### Group: Distorts ###
- Author: Andrew Corcoran
+ ## Author: Andrew Corcoran ##
Trace the edges in your picture, over a white background.
diff --git a/magic/magic-docs/en/emboss.txt b/magic/magic-docs/en/emboss.txt
index 5539846ab..c3d7346d3 100644
--- a/magic/magic-docs/en/emboss.txt
+++ b/magic/magic-docs/en/emboss.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Emboss
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes parts of your picture look "embossed." Wherever there are sharp
edges in your picture, the picture will look raised like it was stamped in
diff --git a/magic/magic-docs/en/epitrochoid.txt b/magic/magic-docs/en/epitrochoid.txt
index a12d8c33f..87ed63923 100644
--- a/magic/magic-docs/en/epitrochoid.txt
+++ b/magic/magic-docs/en/epitrochoid.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Epitrochoid
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of an epitrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/epitrochoid_edge.txt b/magic/magic-docs/en/epitrochoid_edge.txt
index 2ef6db885..d3b7c7681 100644
--- a/magic/magic-docs/en/epitrochoid_edge.txt
+++ b/magic/magic-docs/en/epitrochoid_edge.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Epitrochoid Edge
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of an epitrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/epitrochoid_inside.txt b/magic/magic-docs/en/epitrochoid_inside.txt
index 1c17a0218..8db69dbc4 100644
--- a/magic/magic-docs/en/epitrochoid_inside.txt
+++ b/magic/magic-docs/en/epitrochoid_inside.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Epitrochoid Inside
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of an epitrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/epitrochoid_outside.txt b/magic/magic-docs/en/epitrochoid_outside.txt
index 7ef2090a6..46459d237 100644
--- a/magic/magic-docs/en/epitrochoid_outside.txt
+++ b/magic/magic-docs/en/epitrochoid_outside.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Epitrochoid Outside
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of an epitrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/fill.txt b/magic/magic-docs/en/fill.txt
index 68871be2a..282173880 100644
--- a/magic/magic-docs/en/fill.txt
+++ b/magic/magic-docs/en/fill.txt
@@ -1,6 +1,6 @@
Tux Paint "Magic" Tool: Fill
- By Bill Kendrick
+ ### By Bill Kendrick ###
This floods the picture with a color. It lets you quickly fill parts of the
picture, as if it were a coloring book.
diff --git a/magic/magic-docs/en/filled_polygon.txt b/magic/magic-docs/en/filled_polygon.txt
index 2692e8bfe..fdbfe963b 100644
--- a/magic/magic-docs/en/filled_polygon.txt
+++ b/magic/magic-docs/en/filled_polygon.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Filled Polygon
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Place three or more connected points on your picture to form a polygon; it will
be filled with the currently-chosen color. (Connect the final (red) point to
diff --git a/magic/magic-docs/en/fisheye.txt b/magic/magic-docs/en/fisheye.txt
index f174fa815..9f10d1067 100644
--- a/magic/magic-docs/en/fisheye.txt
+++ b/magic/magic-docs/en/fisheye.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Fisheye
- Group: Distorts
+ ### Group: Distorts ###
- Author: Adam Rakowski
+ ## Author: Adam Rakowski ##
Warp parts of your picture like it's being seen through a fisheye lens.
diff --git a/magic/magic-docs/en/flip.txt b/magic/magic-docs/en/flip.txt
index 2f8120dc5..9815c937b 100644
--- a/magic/magic-docs/en/flip.txt
+++ b/magic/magic-docs/en/flip.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Flip
- Group: Picture Warps
+ ### Group: Picture Warps ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Similar to "Mirror." Click and the entire image will be turned upside-down.
diff --git a/magic/magic-docs/en/flower.txt b/magic/magic-docs/en/flower.txt
index 1b8d2129a..f16894bec 100644
--- a/magic/magic-docs/en/flower.txt
+++ b/magic/magic-docs/en/flower.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Flower
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This tool draws small flowers, with leafy bases and stalks. Click to set the
base, then drag the mouse upwards to draw the stalk, and finally release the
diff --git a/magic/magic-docs/en/foam.txt b/magic/magic-docs/en/foam.txt
index cf35ae5a5..5d78b1c60 100644
--- a/magic/magic-docs/en/foam.txt
+++ b/magic/magic-docs/en/foam.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Foam
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag the mouse to draw foamy bubbles. The more you drag the mouse in
a particular spot, the more likely small bubbles will combine to form bigger
diff --git a/magic/magic-docs/en/fold.txt b/magic/magic-docs/en/fold.txt
index b5a92c6d5..e03306647 100644
--- a/magic/magic-docs/en/fold.txt
+++ b/magic/magic-docs/en/fold.txt
@@ -1,10 +1,11 @@
Tux Paint "Magic" Tool: Fold
- Group: Picture Warps
+ ### Group: Picture Warps ###
- Authors: Adam Rakowski
+ ## Authors: Adam Rakowski
Bill Kendrick
Pere Pujal i Carabantes
+ ##
Click a corner of your picture and drag towards the center to fold it up like a
piece of paper.
diff --git a/magic/magic-docs/en/fractal.txt b/magic/magic-docs/en/fractal.txt
index 62187fefd..2d89ad4b3 100644
--- a/magic/magic-docs/en/fractal.txt
+++ b/magic/magic-docs/en/fractal.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Fractal
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
A set of tools that recursively repeat what you draw, scaling and/or rotating
it as they repeat.
diff --git a/magic/magic-docs/en/fretwork.txt b/magic/magic-docs/en/fretwork.txt
index c4e77f46e..1838aab86 100644
--- a/magic/magic-docs/en/fretwork.txt
+++ b/magic/magic-docs/en/fretwork.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Fretwork
- Group: Painting
+ ### Group: Painting ###
- Author: Pere Pujal i Carabantes
+ ## Author: Pere Pujal i Carabantes ##
Draw an interlaced decorative design that looks like wooden fretwork.
diff --git a/magic/magic-docs/en/fur.txt b/magic/magic-docs/en/fur.txt
index 481753a2f..92a0c317a 100644
--- a/magic/magic-docs/en/fur.txt
+++ b/magic/magic-docs/en/fur.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Fur
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Add fur to your drawing.
diff --git a/magic/magic-docs/en/glass_tile.txt b/magic/magic-docs/en/glass_tile.txt
index 0fda06708..7893701da 100644
--- a/magic/magic-docs/en/glass_tile.txt
+++ b/magic/magic-docs/en/glass_tile.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Glass Tile
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag over your picture to make it look like it's being seen through
glass tiles.
diff --git a/magic/magic-docs/en/googlyeyes.txt b/magic/magic-docs/en/googlyeyes.txt
index 218ba17e1..abac69bb7 100644
--- a/magic/magic-docs/en/googlyeyes.txt
+++ b/magic/magic-docs/en/googlyeyes.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Googly Eyes
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draws a googly eye where you click. Drag to position the pupil. (If the Magic
size feature is disabled, multiple "Googly Eyes" tools will be made available.)
diff --git a/magic/magic-docs/en/grass.txt b/magic/magic-docs/en/grass.txt
index f4e2cc861..c0f713503 100644
--- a/magic/magic-docs/en/grass.txt
+++ b/magic/magic-docs/en/grass.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Grass
- Group: Painting
+ ### Group: Painting ###
- Author: Albert Cahalan
+ ## Author: Albert Cahalan ##
This paints grass on the image. The higher up the canvas, the smaller the grass
is drawn, giving an illusion of perspective. The grass can be tinted various
diff --git a/magic/magic-docs/en/halftone.txt b/magic/magic-docs/en/halftone.txt
index e731a21fd..da9b944bd 100644
--- a/magic/magic-docs/en/halftone.txt
+++ b/magic/magic-docs/en/halftone.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Halftone
- Group: Distorts
+ ### Group: Distorts ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This makes parts of your picture look like newsprint. Different sizes of cyan,
magenta, yellow, and black "ink" will appear in place of your picture.
diff --git a/magic/magic-docs/en/hexagon_mosaic.txt b/magic/magic-docs/en/hexagon_mosaic.txt
index b87a7fab8..7f02c352f 100644
--- a/magic/magic-docs/en/hexagon_mosaic.txt
+++ b/magic/magic-docs/en/hexagon_mosaic.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Hexagon Mosaic
- Group: Distorts
+ ### Group: Distorts ###
- Author: Pere Pujal i Carabantes
+ ## Author: Pere Pujal i Carabantes ##
Converts parts of your picture into a mosaic of hexagon cells.
diff --git a/magic/magic-docs/en/hypotrochoid.txt b/magic/magic-docs/en/hypotrochoid.txt
index 1d58b4554..eb1e0cb38 100644
--- a/magic/magic-docs/en/hypotrochoid.txt
+++ b/magic/magic-docs/en/hypotrochoid.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Hypotrochoid
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of a hypotrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/hypotrochoid_edge.txt b/magic/magic-docs/en/hypotrochoid_edge.txt
index f7e53be5b..bab3eb771 100644
--- a/magic/magic-docs/en/hypotrochoid_edge.txt
+++ b/magic/magic-docs/en/hypotrochoid_edge.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Hypotrochoid Edge
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of a hypotrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/hypotrochoid_inside.txt b/magic/magic-docs/en/hypotrochoid_inside.txt
index fa6781a63..953d3416d 100644
--- a/magic/magic-docs/en/hypotrochoid_inside.txt
+++ b/magic/magic-docs/en/hypotrochoid_inside.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Hypotrochoid Inside
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of a hypotrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/hypotrochoid_outside.txt b/magic/magic-docs/en/hypotrochoid_outside.txt
index 5ef0d4ca7..37321525e 100644
--- a/magic/magic-docs/en/hypotrochoid_outside.txt
+++ b/magic/magic-docs/en/hypotrochoid_outside.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Hypotrochoid Outside
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click to place the center of a hypotrochoid curve, then drag left/right to
adjust the radius of a fixed circle, and up/down to adjust the radius of the
diff --git a/magic/magic-docs/en/index.txt b/magic/magic-docs/en/index.txt
index 8e385941b..5d779324c 100644
--- a/magic/magic-docs/en/index.txt
+++ b/magic/magic-docs/en/index.txt
@@ -1,6 +1,6 @@
Tux Paint "Magic" Tool: List of Magic Tools
-Distorts
+ ### Distorts ###
* Blur
* Sharpen
@@ -31,7 +31,7 @@ Distorts
* Noise
* Halftone
-Color Filters
+ ### Color Filters ###
* Negative
* Opposite
@@ -53,7 +53,7 @@ Color Filters
* Xor Colors
* Bloom
-Picture Warps
+ ### Picture Warps ###
* Mirror
* Flip
@@ -71,7 +71,7 @@ Picture Warps
* Kaleido-4, Kaleido-6, and Kaleido-8
* Rotate
-Painting
+ ### Painting ###
* Bricks
* Spray Paint
@@ -104,7 +104,7 @@ Painting
* Light
* Fractal
-Pattern Painting
+ ### Pattern Painting ###
* Symmetry Left/Right
* Symmetry Up/Down
@@ -116,14 +116,14 @@ Pattern Painting
* Tessellation Pointy
* Tessellation Flat
-Picture Decorations
+ ### Picture Decorations ###
* Blind
* Checkerboard
* Snow Ball
* Snow Flake
-Projections
+ ### Projections ###
* 1-Point Draw
* 1-Point Select
@@ -139,7 +139,7 @@ Projections
* Oblique Draw
* Oblique Select
-Artistic
+ ### Artistic ###
* Flower
* Googly Eyes
diff --git a/magic/magic-docs/en/irregular_mosaic.txt b/magic/magic-docs/en/irregular_mosaic.txt
index 946a173db..47d662a3d 100644
--- a/magic/magic-docs/en/irregular_mosaic.txt
+++ b/magic/magic-docs/en/irregular_mosaic.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Irregular Mosaic
- Group: Distorts
+ ### Group: Distorts ###
- Author: Pere Pujal i Carabantes
+ ## Author: Pere Pujal i Carabantes ##
Converts parts of your picture into a mosaic of irregularly-shaped cells.
diff --git a/magic/magic-docs/en/isometric_line.txt b/magic/magic-docs/en/isometric_line.txt
index a5ab44733..4de8537c4 100644
--- a/magic/magic-docs/en/isometric_line.txt
+++ b/magic/magic-docs/en/isometric_line.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Isometric Line
- Group: Projections
+ ### Group: Projections ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw in an isometric projection. Lines will only go
vertically, or at two mirrored angles. (The angles are preset and evenly spaced
diff --git a/magic/magic-docs/en/kaleidoscope.txt b/magic/magic-docs/en/kaleidoscope.txt
index 5fa848196..bb59aad84 100644
--- a/magic/magic-docs/en/kaleidoscope.txt
+++ b/magic/magic-docs/en/kaleidoscope.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Kaleidoscope
- Group: Pattern Painting
+ ### Group: Pattern Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This paint brush draws in four places at the same time, mirroring
symmetrically, both horizontally and vertically. It uses the currently selected
diff --git a/magic/magic-docs/en/kaleidoscope_lens.txt b/magic/magic-docs/en/kaleidoscope_lens.txt
index ab354f5aa..4c11b9004 100644
--- a/magic/magic-docs/en/kaleidoscope_lens.txt
+++ b/magic/magic-docs/en/kaleidoscope_lens.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Kaleido-4, Kaleido-6, and Kaleido-8
- Group: Picture Warps
+ ### Group: Picture Warps ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
These three tools make it look like your picture is being viewed through a
kaleidoscope.
diff --git a/magic/magic-docs/en/keep_color.txt b/magic/magic-docs/en/keep_color.txt
index 11a1a257b..a0600bc03 100644
--- a/magic/magic-docs/en/keep_color.txt
+++ b/magic/magic-docs/en/keep_color.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Keep Color
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This completely desaturates (turns greyscale) any parts of the image that do
not match the selected color.
diff --git a/magic/magic-docs/en/light.txt b/magic/magic-docs/en/light.txt
index ad9eec3be..a92c4d19b 100644
--- a/magic/magic-docs/en/light.txt
+++ b/magic/magic-docs/en/light.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Light
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This draws a glowing beam on the canvas, in the currently-selected color. The
more you use it on one spot, the more white it becomes.
diff --git a/magic/magic-docs/en/lighten.txt b/magic/magic-docs/en/lighten.txt
index d22abbb72..1ab8023e9 100644
--- a/magic/magic-docs/en/lighten.txt
+++ b/magic/magic-docs/en/lighten.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Lighten
- Group: Color Filters
+ ### Group: Color Filters ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
This fades the colors wherever you drag the mouse. (Do it to the same spot many
times, and it will eventually become white.)
diff --git a/magic/magic-docs/en/lightning.txt b/magic/magic-docs/en/lightning.txt
index ebd288e2e..050abc301 100644
--- a/magic/magic-docs/en/lightning.txt
+++ b/magic/magic-docs/en/lightning.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Lightning
- Group: Artistic
+ ### Group: Artistic ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draws a lightning bolt between two points on the picture.
diff --git a/magic/magic-docs/en/loops.txt b/magic/magic-docs/en/loops.txt
index 047f4d6b2..975926113 100644
--- a/magic/magic-docs/en/loops.txt
+++ b/magic/magic-docs/en/loops.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Loops
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Draw loop-the-loops on the canvas, in the currently-selected color.
diff --git a/magic/magic-docs/en/maze.txt b/magic/magic-docs/en/maze.txt
index 2d5e97a4e..3bc4243b9 100644
--- a/magic/magic-docs/en/maze.txt
+++ b/magic/magic-docs/en/maze.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Maze
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to construct a maze on your picture.
diff --git a/magic/magic-docs/en/metal_paint.txt b/magic/magic-docs/en/metal_paint.txt
index e26a92946..a2100976a 100644
--- a/magic/magic-docs/en/metal_paint.txt
+++ b/magic/magic-docs/en/metal_paint.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Metal Paint
- Group: Painting
+ ### Group: Painting ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
Click and drag to draw shiny metal using the current color.
diff --git a/magic/magic-docs/en/mirror.txt b/magic/magic-docs/en/mirror.txt
index 7b7e223ca..ef008719b 100644
--- a/magic/magic-docs/en/mirror.txt
+++ b/magic/magic-docs/en/mirror.txt
@@ -1,8 +1,8 @@
Tux Paint "Magic" Tool: Mirror
- Group: Picture Warps
+ ### Group: Picture Warps ###
- Author: Bill Kendrick
+ ## Author: Bill Kendrick ##
When you click the mouse in your picture with the "Mirror" magic effect
selected, the entire image will be reversed, turning it into a mirror image.
diff --git a/magic/magic-docs/en/mosaic.txt b/magic/magic-docs/en/mosaic.txt
index ec38110d3..8f7657320 100644
--- a/magic/magic-docs/en/mosaic.txt
+++ b/magic/magic-docs/en/mosaic.txt
@@ -1,9 +1,10 @@
Tux Paint "Magic" Tool: Mosaic
- Group: Distorts
+ ### Group: Distorts ###
- Authors: Adam Rakowski
+ ## Authors: Adam Rakowski