1<?xml version="1.0" encoding="UTF-8"?> 2<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.docbook.org/xml/4.3/docbookx.dtd"> 4<!-- section history: 5 2012-03-04 j.h: updated to v2.8 6 2012-03-02 j.h: added link to tagging 7 2008-12-15 j.h: updated to v2.6 8 2007-10-05 j.h: updated to v2.4.New options added 9 2007-08-15 j.h: v2.4 added Edit Active Palette option en;fr 10 2006-04-29 lexa: made docbook compliant 11 2005-11-29 replaced informalfigures by figures by lexa 12--> 13<sect2 id="gimp-palette-dialog"> 14 <title>Palettes Dialog</title> 15 16 <indexterm> 17 <primary>Dialogs</primary> 18 <secondary>Palettes</secondary> 19 </indexterm> 20 <indexterm> 21 <primary>Palette</primary> 22 <secondary>Dialog</secondary> 23 </indexterm> 24 <indexterm> 25 <primary>Color</primary> 26 <secondary>Palettes</secondary> 27 </indexterm> 28 29 <para> 30 A <emphasis>palette</emphasis> is a set of discrete colors, in no 31 particular order. See the 32 <link linkend="gimp-concepts-palettes">Palettes</link> section for basic 33 information on palettes and how they can be created and used. 34 </para> 35 <para> 36 The <quote>Palettes</quote> dialog is used to select a palette, by 37 clicking on it in a list or grid view. A few dozen more or less randomly 38 chosen palettes are supplied with GIMP, and you can easily add new 39 palettes of your own. The <quote>Palettes</quote> dialog also give you 40 access to several operations for creating new palettes or manipulating 41 the ones that already exist. 42 </para> 43 <note> 44 <para> 45 The <quote>Palettes</quote> dialog is not the same thing as the 46 <link linkend="gimp-indexed-palette-dialog">Index Palette 47 dialog</link>, 48 which is used to manipulate the colormaps of indexed images. 49 </para> 50 </note> 51 52 <sect3 id="gimp-palette-activate"> 53 <title>Activating the dialog</title> 54 <para> 55 The <quote>Palettes</quote> dialog is a dockable dialog; see the section 56 <xref linkend="gimp-concepts-docks"/> for help on manipulating it. 57 </para> 58 <para> 59 You can access it: 60 </para> 61 <itemizedlist> 62 <listitem> 63 <para> 64 from the image menu: 65 <menuchoice> 66 <guimenu>Windows</guimenu> 67 <guisubmenu>Dockable Dialogs</guisubmenu> 68 <guimenuitem>Palettes</guimenuitem> 69 </menuchoice>; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 from the Tab menu in any dockable dialog by clicking on 75 <guiicon> 76 <inlinegraphic fileref="images/dialogs/stock-menu-left-12.png"/> 77 </guiicon> and selecting 78 <menuchoice> 79 <guimenu>Add Tab</guimenu> 80 <guimenuitem>Palettes</guimenuitem> 81 </menuchoice>. 82 </para> 83 </listitem> 84 </itemizedlist> 85 </sect3> 86 87 <sect3 id="gimp-palette-dialog-using"> 88 <title>Using the Palettes dialog</title> 89 <para> 90 Clicking on a palette in the dialog selects this palette and brings up 91 the <link linkend="gimp-palette-editor-dialog">Palette Editor</link>, 92 which allows you to set GIMP's foreground or background colors by 93 clicking on colors in the palette display. You can also use the 94 arrow keys to select a palette. 95 </para> 96 <para> 97 Double-clicking on a palette <emphasis>name</emphasis> 98 (in List View mode) lets you to edit the name. Note that you are only 99 allowed to change the names of palettes that you have added yourself, 100 not those that are supplied with GIMP. If you edit a name that you are 101 not allowed to change, it will revert back to its previous value as soon 102 as you hit return or move the pointer focus elsewhere. 103 </para> 104 <variablelist> 105 <varlistentry> 106 <term>Grid/List modes</term> 107 <listitem> 108 <figure> 109 <title>The <quote>Palettes</quote> dialog</title> 110 <mediaobject> 111 <imageobject> 112 <imagedata format="PNG" 113 fileref="images/dialogs/palettes-grid-dialog.png"/> 114 </imageobject> 115 <caption> 116 <para>Grid View</para> 117 </caption> 118 </mediaobject> 119 <mediaobject> 120 <imageobject> 121 <imagedata format="PNG" 122 fileref="images/dialogs/palettes-dialog.png"/> 123 </imageobject> 124 <caption> 125 <para>List View</para> 126 </caption> 127 </mediaobject> 128 </figure> 129 <para> 130 In the Tab menu, you can choose between 131 <guimenuitem>View as Grid</guimenuitem> 132 and <guimenuitem>View as List</guimenuitem>. 133 In Grid mode, the palettes are laid out in a spectacular 134 rectangular array, making it easy to see many at once and find 135 the one you are looking for. In List mode (the default), the 136 palettes are lined up in a list, with the names beside them. 137 </para> 138 <para> 139 The option <guilabel>Preview Size</guilabel> allows you to adapt 140 the size of color cell previews to your liking. 141 </para> 142 </listitem> 143 </varlistentry> 144 </variablelist> 145 146 <variablelist id="gimp-palettes-dialog-tags"> 147 <varlistentry> 148 <term>Tagging</term> 149 <listitem> 150 <para> 151 You can use tags to reorganize the palettes display. 152 See <xref linkend="gimp-tagging"/>. 153 </para> 154 </listitem> 155 </varlistentry> 156 </variablelist> 157 158 <variablelist> 159 <title>The buttons of the Palettes Dialog</title> 160 <para> 161 Below the palettes view, at the bottom of the dialog window, there are 162 several buttons: 163 </para> 164 <varlistentry> 165 <term> 166 <guiicon> 167 <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/> 168 </guiicon> 169 <phrase condition="tag-is-required">Edit Palette</phrase> 170 </term> 171 <listitem> 172 <para> 173 This button brings up the 174 <xref linkend="gimp-palette-editor-dialog"/>. 175 </para> 176 </listitem> 177 </varlistentry> 178 <varlistentry id="palette-new"> 179 <term> 180 <guiicon> 181 <inlinegraphic fileref="images/dialogs/dialogs-icon-new.png"/> 182 </guiicon> 183 <phrase condition="tag-is-required">New Palette</phrase> 184 </term> 185 <listitem> 186 <indexterm> 187 <primary>Palette</primary> 188 <secondary>New palette</secondary> 189 </indexterm> 190 <para> 191 For more information on this button please refer to 192 <xref linkend="gimp-palette-new"/>. 193 </para> 194 </listitem> 195 </varlistentry> 196 <varlistentry> 197 <term> 198 <guiicon> 199 <inlinegraphic fileref="images/dialogs/stock-duplicate-16.png"/> 200 </guiicon> 201 <phrase condition="tag-is-required">Duplicate Palette</phrase> 202 </term> 203 <listitem> 204 <indexterm> 205 <primary>Palette</primary> 206 <secondary>Duplicate</secondary> 207 </indexterm> 208 <para> 209 For more information on this button please refer to 210 <xref linkend="gimp-palette-duplicate"/>. 211 </para> 212 </listitem> 213 </varlistentry> 214 <varlistentry> 215 <term> 216 <guiicon> 217 <inlinegraphic fileref="images/dialogs/dialogs-icon-delete.png"/> 218 </guiicon> 219 <phrase condition="tag-is-required">Delete Palette</phrase> 220 </term> 221 <listitem> 222 <indexterm> 223 <primary>Palette</primary> 224 <secondary>Delete</secondary> 225 </indexterm> 226 <para> 227 For more information on this button please refer to 228 <xref linkend="gimp-palette-delete"/>. 229 </para> 230 </listitem> 231 </varlistentry> 232 <varlistentry> 233 <term> 234 <guiicon> 235 <inlinegraphic fileref="images/dialogs/stock-reload-16.png"/> 236 </guiicon> 237 <phrase condition="tag-is-required">Refresh Palettes</phrase> 238 </term> 239 <listitem> 240 <indexterm> 241 <primary>Palette</primary> 242 <secondary>Refresh</secondary> 243 </indexterm> 244 <para> 245 For more information on this button please refer to 246 <xref linkend="gimp-palette-refresh"/>. 247 </para> 248 </listitem> 249 </varlistentry> 250 </variablelist> 251 </sect3> 252 253 <sect3 id="gimp-concepts-palettes-menu"> 254 <title>The <quote>Palettes</quote> pop-menu</title> 255 <indexterm> 256 <primary>Palette</primary> 257 <secondary>Menu</secondary> 258 </indexterm> 259 <figure> 260 <title>The <quote>Palettes</quote> pop-menu</title> 261 <mediaobject> 262 <imageobject> 263 <imagedata format="PNG" 264 fileref="images/dialogs/palettes-popmenu.png"/> 265 </imageobject> 266 </mediaobject> 267 </figure> 268 <para> 269 The <quote>Palettes</quote> pop-menu can be accessed by right-clicking 270 in the Palettes dialog, or by choosing the top item from the dialog Tab 271 menu 272 (<inlinegraphic fileref="images/dialogs/stock-menu-left-12.png"/>). 273 </para> 274 <note> 275 <para> 276 Some of the listed pop-menu entries are installation-dependent 277 and need the <ulink url="http://www.python.org">Python language 278 interpreter</ulink> to be installed. This includes at the 279 time of writing: <link linkend="gimp-palette-offset">Offset 280 Palette...</link>, <link 281 linkend="gimp-palette-to-gradient">Palette to gradient</link>, 282 <link linkend="gimp-palette-to-repeat-gradient">Palette to 283 Repeating Gradient</link> and <link 284 linkend="gimp-palette-sort">Sort Palette...</link>. 285 </para> 286 </note> 287 <variablelist> 288 <varlistentry> 289 <term id="gimp-palette-edit">Edit Palette</term> 290 <listitem> 291 <para> 292 <quote>Edit Palette</quote> is an alternative way of activating 293 the 294 <link linkend="gimp-palette-editor-dialog">Palette Editor</link>: 295 it can also be activated by double-clicking on a palette in the 296 Palettes dialog, or by pressing the <quote>Edit Palette</quote> 297 <guiicon> 298 <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/> 299 </guiicon> 300 button at the bottom of the dialog. 301 </para> 302 </listitem> 303 </varlistentry> 304 <varlistentry> 305 <term id="gimp-palette-new">New Palette</term> 306 <listitem> 307 <para> 308 <quote>New Palette</quote> creates a new, untitled palette, 309 initially containing no color entries, and pops up the Palette 310 Editor so that you can add colors to the palette. The result 311 will automatically be saved in your personal 312 <filename>palettes</filename> folder when you quit GIMP, so it 313 will be available from the Palettes dialog in future sessions. 314 </para> 315 </listitem> 316 </varlistentry> 317 <varlistentry> 318 <term id="gimp-palette-import">Import Palette</term> 319 <listitem> 320 <indexterm> 321 <primary>Palette</primary> 322 <secondary>Import</secondary> 323 </indexterm> 324 <figure> 325 <title>The Import Palette dialog</title> 326 <mediaobject> 327 <imageobject> 328 <imagedata format="PNG" 329 fileref="images/dialogs/palette-import-dialog.png"/> 330 </imageobject> 331 </mediaobject> 332 </figure> 333 <para> 334 <quote>Import Palette</quote> 335 allows you to create a new palette from the colors in a gradient, 336 an image or a palette file. Choosing it brings up the 337 <quote>Import Palette</quote> dialog, which gives you the 338 following options: 339 </para> 340 <note> 341 <para> 342 Former versions of GIMP had a <quote>Save palette</quote> 343 command. It no longer exists. To save the palette of an image, 344 indexed or not, you must <emphasis>import</emphasis> it in fact 345 from the image. 346 </para> 347 </note> 348 <variablelist> 349 <varlistentry> 350 <term>Select Source</term> 351 <listitem> 352 <para> 353 You can import a palette either from any of GIMP's 354 gradients (choosing one from the adjoining menu), or from 355 any of the currently open images (chosen from the adjoining 356 menu). Since GIMP 2.2, you can also import a RIFF palette 357 file (with extension <filename>.pal</filename>), of the 358 type used by several Microsoft Windows applications. 359 </para> 360 <para> 361 Two options concerning image as source, available for RGB 362 images only: 363 </para> 364 <itemizedlist> 365 <listitem> 366 <para> 367 <guilabel>Sample merged</guilabel>: When this option 368 is checked, colors are picked from all visible 369 layers. If unchecked, pixels are picked from the 370 active layer only, even though not visible. 371 </para> 372 </listitem> 373 <listitem> 374 <para> 375 <guilabel>Selected pixels only</guilabel>: As the 376 name says, pixels are picked from the selected area 377 only, in the active layer or all visible layers 378 according to the status of the previous option. 379 </para> 380 </listitem> 381 </itemizedlist> 382 </listitem> 383 </varlistentry> 384 <varlistentry> 385 <term>Palette name</term> 386 <listitem> 387 <para> 388 You can give a name to the new palette here. If the name 389 you choose is already used by an existing palette, a unique 390 name will be formed by appending a number (e. g., "#1"). 391 </para> 392 </listitem> 393 </varlistentry> 394 <varlistentry> 395 <term>Number of colors</term> 396 <listitem> 397 <para> 398 Here you specify the number of colors in the palette. The 399 default is 256, chosen for three reasons: (1) every 400 gradient contains 256 distinct colors; (2) GIF files can 401 use a maximum of 256 colors; (3) GIMP indexed images can 402 contain a maximum of 256 distinct colors. You can use any 403 number you like here, though: GIMP will try to create a 404 palette by spacing the specified number of colors even 405 across the color range of the gradient or image. 406 </para> 407 </listitem> 408 </varlistentry> 409 <varlistentry> 410 <term>Columns</term> 411 <listitem> 412 <para> 413 Here you specify the number of columns for the palette. 414 This only affects the way the palette is displayed, and has 415 no effect on the way the palette is used. 416 </para> 417 </listitem> 418 </varlistentry> 419 <varlistentry> 420 <term>Interval</term> 421 <listitem> 422 <para> 423 Even setting <quote>Number of colors</quote> to maximum, the 424 number of colors can't exceed 10000 in the palette. RGB 425 images have much more colors. <guilabel>Interval</guilabel> 426 should allow to group similar colors around an average and 427 so get a better palette. This problem doesn't exist with 256 428 colors indexed images: Interval to 1 allows picking 256 429 colors (this option is grayed out with more than 256 colors 430 indexed palettes too). 431 </para> 432 </listitem> 433 </varlistentry> 434 </variablelist> 435 <para> 436 The imported palette will be added to the Palettes dialog, and 437 automatically saved in your personal 438 <filename class="directory">palettes</filename> folder when you 439 quit <acronym>GIMP</acronym>, so it will be available in future 440 sessions. 441 </para> 442 </listitem> 443 </varlistentry> 444 <varlistentry> 445 <term id="gimp-palette-duplicate">Duplicate Palette</term> 446 <listitem> 447 <para> 448 Duplicate Palette creates a new palette by copying the palette 449 that is currently selected, and brings up a Palette Editor so that 450 you can alter the palette. The result will automatically be saved 451 in your personal <filename>palettes</filename> 452 folder when you quit GIMP, so it will be available from the 453 Palettes dialog in future sessions. 454 </para> 455 </listitem> 456 </varlistentry> 457 <varlistentry> 458 <term id="gimp-palette-merge">Merge Palettes</term> 459 <listitem> 460 <para> 461 Currently this operation is not implemented, and the menu entry 462 will always be insensitive. 463 </para> 464 </listitem> 465 </varlistentry> 466 <varlistentry> 467 <term id="gimp-palette-location">Copy Palette Location</term> 468 <listitem> 469 <para> 470 This command allows you to copy the palette file location to 471 clipboard. You can then paste it in a text editor. 472 </para> 473 </listitem> 474 </varlistentry> 475 <varlistentry> 476 <term id="gimp-palette-delete">Delete Palette</term> 477 <listitem> 478 <para> 479 Delete Palette removes the palette from the <quote>Palettes 480 </quote>dialog, and deletes the disk file in which it is stored. 481 Before it acts, it asks you confirm that you really want to do 482 these things. Note that you cannot remove any of the palettes 483 that are supplied with GIMP, only palettes you have added 484 yourself. 485 </para> 486 </listitem> 487 </varlistentry> 488 <varlistentry> 489 <term id="gimp-palette-refresh">Refresh Palettes</term> 490 <listitem> 491 <para> 492 Refresh Palettes rescans all of the folders in your palette 493 search path, and adds any newly discovered palettes to the list 494 in the Palettes dialog. This may be useful if you obtain palette 495 files from some external source, copy them into one of your 496 palettes folders, and want to make them available during the 497 current session. 498 </para> 499 </listitem> 500 </varlistentry> 501 <varlistentry> 502 <term id="gimp-palette-offset">Offset Palette... </term> 503 <listitem> 504 <para>This command opens a dialog window:</para> 505 <figure> 506 <title>The <quote>Offset Palette</quote>dialog</title> 507 <mediaobject> 508 <imageobject> 509 <imagedata format="PNG" 510 fileref="images/dialogs/palettes-offset-options.png"/> 511 </imageobject> 512 </mediaobject> 513 </figure> 514 <para> 515 This command takes the last color of the palette and puts it at 516 the first place. The <guilabel>Offset</guilabel> parameter lets 517 you set how many times this action must be performed. 518 </para> 519 <para> 520 With negative <quote>Offsets</quote> colors are put from the first 521 position to the end of the colors list. 522 </para> 523 <figure> 524 <title><quote>Offset Palette</quote> examples</title> 525 <mediaobject> 526 <imageobject> 527 <imagedata format="PNG" 528 fileref="images/dialogs/examples/palettes-offset.png"/> 529 </imageobject> 530 <caption> 531 <para> 532 From top to bottom: original palette, Offset = 1, Offset = 533 2. 534 </para> 535 </caption> 536 </mediaobject> 537 </figure> 538 </listitem> 539 </varlistentry> 540 <varlistentry> 541 <term id="gimp-palette-to-gradient">Palette to gradient</term> 542 <listitem> 543 <indexterm> 544 <primary>Gradient</primary> 545 <secondary>From palette</secondary> 546 </indexterm> 547 <para> 548 With this command, all the colors of the palette are used to form 549 the current gradient which is saved in the Gradient Dialog. The 550 created gradient is build with segments just as much as the number 551 of colors on the given palette. 552 </para> 553 </listitem> 554 </varlistentry> 555 <varlistentry> 556 <term id="gimp-palette-to-repeat-gradient"> 557 Palette to Repeating Gradient 558 </term> 559 <listitem> 560 <para> 561 This command creates a repeating gradient, using all the colors 562 of the palette. This gradient appears in the Gradient Dialog and 563 becomes the current gradient. The gradient is created with 564 segments one more than the number of colors on the given palette. 565 The left side color at the leftmost segment will be the same color 566 on the right side at the rightmost segment. 567 </para> 568 <figure> 569 <title> 570 <quote>Palette to repeating gradient</quote> examples 571 </title> 572 <mediaobject> 573 <imageobject> 574 <imagedata format="PNG" 575 fileref="images/dialogs/examples/palettes-repeat-gradient.png"/> 576 </imageobject> 577 <caption> 578 <para> 579 Top: palette. Bottom: the gradient created with the 580 command. 581 </para> 582 </caption> 583 </mediaobject> 584 </figure> 585 </listitem> 586 </varlistentry> 587 <varlistentry> 588 <term id="gimp-palette-sort">Sort Palette...</term> 589 <listitem> 590 <para> 591 This command opens a dialog window which allows you to sort the 592 colors of the palette according to certain criterions: 593 </para> 594 <figure> 595 <title>The <quote>Sort Palette</quote>dialog</title> 596 <mediaobject> 597 <imageobject> 598 <imagedata format="PNG" 599 fileref="images/dialogs/palettes-sort.png"/> 600 </imageobject> 601 </mediaobject> 602 </figure> 603 <itemizedlist> 604 <listitem> 605 <para> 606 <guilabel>Color model</guilabel>: you can choose between 607 <emphasis>RGB</emphasis> and <emphasis>HSV</emphasis> 608 </para> 609 </listitem> 610 <listitem> 611 <para> 612 <guilabel>Channel to sort</guilabel>: you can choose between 613 the three RGB channels if the RGB model is selected, or the 614 three HSV channels if the HSV channel is selected. 615 </para> 616 </listitem> 617 <listitem> 618 <para> 619 <guilabel>Ascending</guilabel> (default is Yes): values are 620 sorted from the lower to the upper. By clicking on this 621 <guibutton>Yes</guibutton> you can toggle to 622 <guibutton>No</guibutton> and values will be sorted in 623 descending order. 624 </para> 625 </listitem> 626 </itemizedlist> 627 </listitem> 628 </varlistentry> 629 </variablelist> 630 </sect3> 631 632 <sect3 id="gimp-palette-editor-dialog"> 633 <title>Palette Editor</title> 634 <indexterm> 635 <primary>Palette</primary> 636 <secondary>Editor</secondary> 637 </indexterm> 638 <figure> 639 <title>The Palette Editor</title> 640 <mediaobject> 641 <imageobject> 642 <imagedata format="PNG" 643 fileref="images/dialogs/palette-editor-dialog.png"/> 644 </imageobject> 645 </mediaobject> 646 </figure> 647 <para> 648 The Palette Editor is used mainly for two purposes: first, for setting 649 GIMP's foreground or background colors (as shown in the Color Area of 650 the Toolbox) to selected colors from the palette; second, for modifying 651 the palette. You can activate the Palette Editor for any palette in the 652 Palettes dialog, but you can only modify palettes that you have created 653 yourself, not the palettes that are supplied when you install GIMP. 654 (You can, however, duplicate any palette and then edit the newly 655 created copy.) If you modify a palette, the results of your work will 656 automatically be saved when you exit from GIMP. 657 </para> 658 659 <sect4> 660 <title>How to Activate the Palette Editor</title> 661 <para> 662 The Palette Editor is only accessible from the Palettes dialog: you 663 can activate it by double-clicking on a palette, or by pressing the 664 <guiicon> 665 <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/> 666 </guiicon> 667 <quote>Edit Palette</quote> button at the bottom, or by choosing 668 <quote>Edit Palette</quote> from the <quote>Palettes</quote> Menu. 669 </para> 670 <para> 671 The Palette Editor is a dockable dialog; see the section on 672 <link linkend="gimp-concepts-docks">Dialogs and Docking</link> 673 for help on manipulating it. 674 </para> 675 </sect4> 676 677 <sect4> 678 <title>Using the Palette Editor</title> 679 <para> 680 If you click on a color box in the palette display, GIMP's foreground 681 color will be set to the selected color: you can see this in the 682 Color Area of the Toolbox. If you hold down the <keycap>Ctrl</keycap> 683 key while clicking, GIMP's background color will be set to the 684 selected color. 685 </para> 686 <para> 687 If the palette is a custom palette, double-clicking on a color not 688 only sets the foreground, it also brings up a color editor that 689 allows you to modify the selected palette entry. 690 </para> 691 <para> 692 Right-clicking in the palette display area brings up the Palette 693 Editor menu. It's functions are mainly the same as those of the 694 buttons at the bottom of the dialog. 695 </para> 696 <para> 697 Below the palette display area, at the left, appears a text entry 698 area that shows the name of the selected color (or <quote>Untitled 699 </quote> if it does not have one). This information has no functional 700 significance, and is present only to serve you as a memory aid. 701 </para> 702 <para> 703 To the right of the name entry is a spinbutton that allows you to set 704 the number of columns used to display the palette. This only affects 705 the display, not how the palette works. If the value is set to 0, a 706 default will be used. 707 </para> 708 <para> 709 At the bottom of the dialog are a set of buttons, which mostly match 710 the entries in the Palette Editor menu, accessible by right-clicking 711 in the palette display area. Here are the buttons: 712 </para> 713 <variablelist> 714 <varlistentry> 715 <term> 716 <guiicon> 717 <inlinegraphic fileref="images/dialogs/stock-save-16.png"/> 718 </guiicon> 719 <phrase condition="tag-is-required">Save</phrase> 720 </term> 721 <listitem> 722 <para> 723 This button causes the palette to be saved in your personal 724 <filename class="directory">palettes</filename> folder. It 725 would be saved automatically when <acronym>GIMP</acronym> exits 726 in any case, but you might want to use this button if you are 727 concerned that <acronym>GIMP</acronym> might crash in the 728 meantime. 729 </para> 730 </listitem> 731 </varlistentry> 732 <varlistentry> 733 <term> 734 <guiicon> 735 <inlinegraphic fileref="images/dialogs/stock-revert-16.png"/> 736 </guiicon> 737 <phrase condition="tag-is-required">Revert</phrase> 738 </term> 739 <listitem> 740 <para> 741 This operation has not yet been implemented. 742 </para> 743 </listitem> 744 </varlistentry> 745 <varlistentry> 746 <term> 747 <guiicon> 748 <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/> 749 </guiicon> 750 <phrase condition="tag-is-required">Edit Color</phrase> 751 </term> 752 <listitem> 753 <para> 754 Pops up a color editor allowing you to alter the color. If 755 the palette is one you aren't allowed to alter, this button 756 will be insensitive. See 757 <link linkend="gimp-palette-editor-edit">below</link> 758 </para> 759 </listitem> 760 </varlistentry> 761 <varlistentry> 762 <term> 763 <guiicon> 764 <inlinegraphic fileref="images/dialogs/dialogs-icon-new.png"/> 765 </guiicon> 766 <phrase condition="tag-is-required">New Color from FG</phrase> 767 </term> 768 <listitem> 769 <para> 770 For more information on this button please refer to 771 <link linkend="gimp-palette-editor-new">below</link>. 772 </para> 773 </listitem> 774 </varlistentry> 775 <varlistentry> 776 <term> 777 <guiicon> 778 <inlinegraphic fileref="images/dialogs/dialogs-icon-delete.png"/> 779 </guiicon> 780 <phrase condition="tag-is-required">Delete Color</phrase> 781 </term> 782 <listitem> 783 <para> 784 For more information on this button please refer to 785 <link linkend="gimp-palette-editor-delete">below</link>. 786 </para> 787 </listitem> 788 </varlistentry> 789 <varlistentry> 790 <term> 791 <guiicon> 792 <inlinegraphic fileref="images/dialogs/stock-zoom-out-16.png"/> 793 </guiicon> 794 <phrase condition="tag-is-required">Zoom Out</phrase> 795 </term> 796 <listitem> 797 <para> 798 For more information on this button please refer to 799 <link linkend="gimp-palette-editor-zoom-out">below</link>. 800 </para> 801 </listitem> 802 </varlistentry> 803 <varlistentry> 804 <term> 805 <guiicon> 806 <inlinegraphic fileref="images/dialogs/stock-zoom-in-16.png"/> 807 </guiicon> 808 <phrase condition="tag-is-required">Zoom In</phrase> 809 </term> 810 <listitem> 811 <para> 812 For more information on this button please refer to 813 <link linkend="gimp-palette-editor-zoom-in">below</link>. 814 </para> 815 </listitem> 816 </varlistentry> 817 <varlistentry> 818 <term> 819 <guiicon> 820 <inlinegraphic 821 fileref="images/dialogs/stock-zoom-best-fit-16.png"/> 822 </guiicon> 823 <phrase condition="tag-is-required">Zoom All</phrase> 824 </term> 825 <listitem> 826 <para> 827 For more information on this button please refer to 828 <link linkend="gimp-palette-editor-zoom-all">below</link>. 829 </para> 830 </listitem> 831 </varlistentry> 832 </variablelist> 833 </sect4> 834 </sect3> 835 836 <sect3 id="gimp-palette-editor-menu"> 837 <title>The Palette Editor pop-menu</title> 838 <figure> 839 <title>The Palette Editor pop-menu</title> 840 <mediaobject> 841 <imageobject> 842 <imagedata format="PNG" 843 fileref="images/dialogs/palette-editor-context-menu.png"/> 844 </imageobject> 845 </mediaobject> 846 </figure> 847 <para> 848 The Palette Editor Menu can be accessed by right-clicking on the 849 palette display in the Palette Editor, or by choosing the top entry 850 from the dialog Tab menu. The operations in it can also be executed 851 using the buttons at the bottom of the Palette Editor dialog. 852 </para> 853 <variablelist> 854 <varlistentry> 855 <term id="gimp-palette-editor-edit">Edit Color</term> 856 <listitem> 857 <para> 858 <quote>Edit Color</quote> brings up a color editor that allows 859 you to modify the color of the selected palette entry. If 860 the palette is one that you are not allowed to edit (that is, one 861 supplied by GIMP when it is installed), then the menu entry will 862 beinsensitive. 863 </para> 864 </listitem> 865 </varlistentry> 866 <varlistentry> 867 <term id="gimp-palette-editor-new"> 868 New Color from FG; New Color from BG 869 </term> 870 <listitem> 871 <para> 872 These commands each create a new palette entry, using either 873 GIMP's current foreground color (as shown in the Color Area of 874 the Toolbox), or the current background color. 875 </para> 876 </listitem> 877 </varlistentry> 878 <varlistentry> 879 <term id="gimp-palette-editor-delete">Delete Color</term> 880 <listitem> 881 <para> 882 <quote>Delete Color</quote> removes the selected color entry 883 from the palette. 884 If the palette is one that you are not allowed to edit, then the 885 menu entry will be insensitive. 886 </para> 887 </listitem> 888 </varlistentry> 889 <varlistentry> 890 <term id="gimp-palette-editor-zoom-out">Zoom Out</term> 891 <listitem> 892 <para> 893 <quote>Zoom Out</quote> reduces the vertical scale of the 894 entries in the palette display. 895 </para> 896 </listitem> 897 </varlistentry> 898 <varlistentry> 899 <term id="gimp-palette-editor-zoom-in">Zoom In</term> 900 <listitem> 901 <para> 902 <quote>Zoom In</quote> increases the vertical scale of the 903 entries in the palette display. 904 </para> 905 </listitem> 906 </varlistentry> 907 <varlistentry> 908 <term id="gimp-palette-editor-zoom-all">Zoom All</term> 909 <listitem> 910 <para> 911 <quote>Zoom All</quote> adjusts the vertical size of the entries 912 in the palette display so that the entire palette fits into the 913 display area. 914 </para> 915 </listitem> 916 </varlistentry> 917 <varlistentry> 918 <term id="gimp-palette-editor-active">Edit Active Palette</term> 919 <listitem> 920 <para> 921 When this option is checked (default), you can edit another 922 palette by clicking on it in the <quote>Palettes</quote> dialog. 923 </para> 924 </listitem> 925 </varlistentry> 926 </variablelist> 927 </sect3> 928</sect2> 929
