home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / gimp / 2.0 / help / en / gimp-fire-up.html < prev    next >
Encoding:
Extensible Markup Language  |  2008-05-03  |  19.4 KB  |  505 lines
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4.   <head>
  5.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  6.     <title>Chapter¬†2.¬† Fire up the GIMP</title>
  7.     <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
  8.     <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
  9.     <link rel="stylesheet" href="gimp-help-custom.css" type="text/css" />
  10.     <link rel="alternate stylesheet" href="gimp22.css" type="text/css" title="gimp22" />
  11.     <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
  12.     <link rel="start" href="index.html" title="GNU Image Manipulation Program" />
  13.     <link rel="up" href="pt01.html" title="Part¬†I.¬† Getting started" />
  14.     <link rel="prev" href="gimp-introduction-whats-new.html" title="2.¬† What's New in GIMP 2.4?" />
  15.     <link rel="next" href="gimp-concepts-setup.html" title="2.¬† Starting GIMP the first time" />
  16.   </head>
  17.   <body>
  18.     <div class="navheader">
  19.       <table width="100%" summary="Navigation header">
  20.         <tr>
  21.           <th colspan="3" align="center">Chapter¬†2.¬†
  22.         <span lang="en" xml:lang="en">Fire up the GIMP</span>
  23.       </th>
  24.         </tr>
  25.         <tr>
  26.           <td width="20%" align="left"><a accesskey="p" href="gimp-introduction-whats-new.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  27.           <th width="60%" align="center">Part¬†I.¬†
  28.       <span lang="en" xml:lang="en">Getting started</span>
  29.     </th>
  30.           <td width="20%" align="right">¬†<a accesskey="n" href="gimp-concepts-setup.html"><img src="../images/next.png" alt="Next" /></a></td>
  31.         </tr>
  32.       </table>
  33.       <hr />
  34.     </div>
  35.     <div class="chapter" lang="en" xml:lang="en">
  36.       <div class="titlepage">
  37.         <div>
  38.           <div>
  39.             <h2 class="title"><a id="gimp-fire-up"></a>Chapter¬†2.¬†
  40.         <span lang="en" xml:lang="en">Fire up the GIMP</span>
  41.       </h2>
  42.           </div>
  43.         </div>
  44.       </div>
  45.       <div class="toc">
  46.         <p>
  47.           <b>Table of Contents</b>
  48.         </p>
  49.         <dl>
  50.           <dt>
  51.             <span class="sect1">
  52.               <a href="gimp-fire-up.html#gimp-concepts-running">1. 
  53.     <span lang="en" xml:lang="en">Running GIMP</span>
  54.   </a>
  55.             </span>
  56.           </dt>
  57.           <dd>
  58.             <dl>
  59.               <dt>
  60.                 <span class="sect2">
  61.                   <a href="gimp-fire-up.html#introduction-platforms">1.1. 
  62.       <span lang="en" xml:lang="en">Known Platforms</span>
  63.     </a>
  64.                 </span>
  65.               </dt>
  66.               <dt>
  67.                 <span class="sect2">
  68.                   <a href="gimp-fire-up.html#gimp-concepts-running-language">1.2. 
  69.       <span lang="en" xml:lang="en">Language</span>
  70.     </a>
  71.                 </span>
  72.               </dt>
  73.               <dt>
  74.                 <span class="sect2">
  75.                   <a href="gimp-fire-up.html#gimp-concepts-running-command-line">1.3. 
  76.       <span lang="en" xml:lang="en">Command Line Arguments</span>
  77.     </a>
  78.                 </span>
  79.               </dt>
  80.             </dl>
  81.           </dd>
  82.           <dt>
  83.             <span class="sect1">
  84.               <a href="gimp-concepts-setup.html">2. 
  85.     <span lang="en" xml:lang="en">Starting GIMP the first time</span>
  86.   </a>
  87.             </span>
  88.           </dt>
  89.           <dd>
  90.             <dl>
  91.               <dt>
  92.                 <span class="sect2">
  93.                   <a href="gimp-concepts-setup.html#id2581887">2.1. 
  94.       <span lang="en" xml:lang="en">Finally . . .</span>
  95.     </a>
  96.                 </span>
  97.               </dt>
  98.             </dl>
  99.           </dd>
  100.         </dl>
  101.       </div>
  102.       <div class="sect1" lang="en" xml:lang="en">
  103.         <div class="titlepage">
  104.           <div>
  105.             <div>
  106.               <h2 class="title" style="clear: both"><a id="gimp-concepts-running"></a>1.¬†
  107.     <span lang="en" xml:lang="en">Running GIMP</span>
  108.   </h2>
  109.             </div>
  110.             <div>
  111.               <div class="revhistory">
  112.                 <table border="1" width="100%" summary="Revision history">
  113.                   <tr>
  114.                     <th align="left" valign="top" colspan="3">
  115.                       <b>Revision History</b>
  116.                     </th>
  117.                   </tr>
  118.                   <tr>
  119.                     <td align="left">Revision $Revision: 2438 $</td>
  120.                     <td align="left">2007-09-30</td>
  121.                     <td align="left">lexA</td>
  122.                   </tr>
  123.                 </table>
  124.               </div>
  125.             </div>
  126.           </div>
  127.         </div>
  128.         <a id="id2580905" class="indexterm"></a>
  129.         <p>
  130.     Most often, you start GIMP either by clicking on an icon (if your system
  131.     is set up to provide you with one), or by typing <span class="command"><strong>gimp</strong></span>
  132.     on a command line. If you have multiple versions of GIMP installed,
  133.     you may need to type <span class="command"><strong>gimp-2.4</strong></span>
  134.     to get the latest version. You can, if you want, give a list of image
  135.     files on the command line after the program name, and they will
  136.     automatically be opened by GIMP as it starts. It is also possible, though,
  137.     to open files from within GIMP once it is running.
  138.   </p>
  139.         <p>
  140.     In most operating systems, you can set things up so that various
  141.     types of image files are ‚Äú<span class="quote">associated</span>‚Äù with GIMP, and cause
  142.     it to start automatically when icons for them are double-clicked.
  143.   </p>
  144.         <div class="sect2" lang="en" xml:lang="en">
  145.           <div class="titlepage">
  146.             <div>
  147.               <div>
  148.                 <h3 class="title"><a id="introduction-platforms"></a>1.1.¬†
  149.       <span lang="en" xml:lang="en">Known Platforms</span>
  150.     </h3>
  151.               </div>
  152.             </div>
  153.           </div>
  154.           <p>
  155.       The <acronym class="acronym">GIMP</acronym> is the most widely supported image
  156.       manipulation available today. The platforms that The
  157.       <acronym class="acronym">GIMP</acronym> is known to work on include:
  158.     </p>
  159.           <p>
  160.       <span class="productname"><acronym class="acronym">GNU</acronym>/Linux</span>‚Ñ¢,
  161.       <span class="productname">Apple Mac OS X</span>‚Ñ¢,
  162.       <span class="productname">Microsoft Windows</span>‚Ñ¢,
  163.       <span class="productname">OpenBSD</span>‚Ñ¢, <span class="productname">NetBSD</span>‚Ñ¢,
  164.       <span class="productname">FreeBSD</span>‚Ñ¢, <span class="productname">Solaris</span>‚Ñ¢,
  165.       <span class="productname">SunOS</span>‚Ñ¢, <span class="productname">AIX</span>‚Ñ¢,
  166.       <span class="productname">HP-UX</span>‚Ñ¢, <span class="productname">Tru64</span>‚Ñ¢,
  167.       <span class="productname">Digital UNIX</span>‚Ñ¢,
  168.       <span class="productname">OSF/1</span>‚Ñ¢, <span class="productname">IRIX</span>‚Ñ¢,
  169.       <span class="productname">OS/2</span>‚Ñ¢
  170.       <span lang="en" xml:lang="en">and</span>
  171.       <span class="productname">BeOS</span>‚Ñ¢.
  172.     </p>
  173.           <p>
  174.       The <acronym class="acronym">GIMP</acronym> can easily be ported to other
  175.       operating systems because of its source code availability. For further
  176.       information visit the GIMP developers homepage.
  177.       <a class="xref" href="bibliography.html#bibliography-online-gimp-dev" title="GIMP Development">[<abbr class="abbrev">GIMP-DEV</abbr>]</a>.
  178.     </p>
  179.         </div>
  180.         <div class="sect2" lang="en" xml:lang="en">
  181.           <div class="titlepage">
  182.             <div>
  183.               <div>
  184.                 <h3 class="title"><a id="gimp-concepts-running-language"></a>1.2.¬†
  185.       <span lang="en" xml:lang="en">Language</span>
  186.     </h3>
  187.               </div>
  188.             </div>
  189.           </div>
  190.           <a id="id2581102" class="indexterm"></a>
  191.           <p>
  192.       All being well, GIMP detects the system language. This may fail on some
  193.       machines and you may want use another language. It is possible to change
  194.       the language:
  195.     </p>
  196.           <div class="variablelist">
  197.             <dl>
  198.               <dt>
  199.                 <span class="term">Linux</span>
  200.               </dt>
  201.               <dd>
  202.                 <p>
  203.             <span class="emphasis"><em>In LINUX</em></span>: in console mode,
  204.             type <strong class="userinput"><code>LANGUAGE=en gimp</code></strong> or
  205.             <strong class="userinput"><code>LANG=en gimp</code></strong>
  206.             replacing en by fr, de, ... according to the language you
  207.             want. Background: By using <strong class="userinput"><code>LANGUAGE=en</code></strong>
  208.             you're setting an environment variable for the executed
  209.             program <strong class="userinput"><code>gimp</code></strong> here.
  210.           </p>
  211.               </dd>
  212.               <dt>
  213.                 <span class="term">Windows XP</span>
  214.               </dt>
  215.               <dd>
  216.                 <p>
  217.             <span class="guimenu">Control Panel</span> ‚Üí <span class="guisubmenu">System</span> ‚Üí <span class="guisubmenu">Advanced</span> ‚Üí <span class="guimenuitem">Environment</span>
  218.             button in ‚Äú<span class="quote">System Variables</span>‚Äù area:
  219.             <span class="guibutton">Add</span> button: Enter LANG for Name and fr or
  220.             de... for Value. Watch out! You have to click on three successive
  221.             <span class="guibutton">OK</span> to validate your choice.
  222.           </p>
  223.                 <p>
  224.             If you often change language, you can create a batch file. Open
  225.             NotePad. Type the following commands (for french for instance):
  226.             </p>
  227.                 <div class="literallayout">
  228.                   <p><br />
  229. ¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†set¬†lang=fr<br />
  230. ¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†cd¬†c:\Program¬†Files\GIMP-2.0\bin<br />
  231. ¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†¬†GIMP-2.4.exe<br />
  232.             </p>
  233.                 </div>
  234.                 <p>
  235.             Save this file as GIMP-FR.BAT (or another name, but always with a
  236.             .BAT extension. Create shortcut and drag it to your desktop.
  237.           </p>
  238.               </dd>
  239.               <dt>
  240.                 <span class="term">
  241.           <span>Apple Mac OS X</span>
  242.         </span>
  243.               </dt>
  244.               <dd>
  245.                 <p>
  246.             Go to System Preferences, click on the International icon, and in
  247.             the Language tab, the desired language should be the first in the
  248.             list.
  249.           </p>
  250.               </dd>
  251.             </dl>
  252.           </div>
  253.         </div>
  254.         <div class="sect2" lang="en" xml:lang="en">
  255.           <div class="titlepage">
  256.             <div>
  257.               <div>
  258.                 <h3 class="title"><a id="gimp-concepts-running-command-line"></a>1.3.¬†
  259.       <span lang="en" xml:lang="en">Command Line Arguments</span>
  260.     </h3>
  261.               </div>
  262.             </div>
  263.           </div>
  264.           <a id="id2581279" class="indexterm"></a>
  265.           <p>
  266.       Ordinarily you don't need to give any arguments when starting
  267.       GIMP, but here is a list of some that may at one time or another be
  268.       useful.  This is not a complete list; on Unix systems you can get
  269.       a complete list by running <strong class="userinput"><code>man gimp</code></strong> in a
  270.       terminal window.
  271.     </p>
  272.           <p>
  273.       To use the command line options, you have to put them in the command
  274.       line which you use to start GIMP as
  275.       <span class="command"><strong>gimp-2.4 [OPTION...] [FILE|URI...]</strong></span>.
  276.     </p>
  277.           <div class="variablelist">
  278.             <dl>
  279.               <dt>
  280.                 <span class="term">-?, --help</span>
  281.               </dt>
  282.               <dd>
  283.                 <p>Display a list of all commandline options.</p>
  284.               </dd>
  285.               <dt>
  286.                 <span class="term">--help-all</span>
  287.               </dt>
  288.               <dd>
  289.                 <p>Show all help options.</p>
  290.               </dd>
  291.               <dt>
  292.                 <span class="term">--help-gtk</span>
  293.               </dt>
  294.               <dd>
  295.                 <p>Show GTK+ Options.</p>
  296.               </dd>
  297.               <dt>
  298.                 <span class="term">-v, --version</span>
  299.               </dt>
  300.               <dd>
  301.                 <p>
  302.             Print the version of GIMP being used, and exit.
  303.           </p>
  304.               </dd>
  305.               <dt>
  306.                 <span class="term">--license</span>
  307.               </dt>
  308.               <dd>
  309.                 <p>Show license information and exit</p>
  310.               </dd>
  311.               <dt>
  312.                 <span class="term">--verbose</span>
  313.               </dt>
  314.               <dd>
  315.                 <p>Show detailed start-up messages.</p>
  316.               </dd>
  317.               <dt>
  318.                 <span class="term">-n, --new-instance</span>
  319.               </dt>
  320.               <dd>
  321.                 <p>Start a new GIMP instance.</p>
  322.               </dd>
  323.               <dt>
  324.                 <span class="term">-a, --as-new</span>
  325.               </dt>
  326.               <dd>
  327.                 <p>Open images as new.</p>
  328.               </dd>
  329.               <dt>
  330.                 <span class="term">-i, --no-interface</span>
  331.               </dt>
  332.               <dd>
  333.                 <p>Run without a user interface.</p>
  334.               </dd>
  335.               <dt>
  336.                 <span class="term">-d, --no-data</span>
  337.               </dt>
  338.               <dd>
  339.                 <p>
  340.             Do not load patterns, gradients, palettes, or brushes. Often
  341.             useful in non-interactive situations where start-up time is to be
  342.             minimized.
  343.           </p>
  344.               </dd>
  345.               <dt>
  346.                 <span class="term">-f, --no-fonts</span>
  347.               </dt>
  348.               <dd>
  349.                 <p>Do not load any fonts. This option could be
  350.           useful either for speeding up GIMP start-up for scripts that
  351.           does not use fonts or to find malformed fonts related problems
  352.           that could hang GIMP.</p>
  353.               </dd>
  354.               <dt>
  355.                 <span class="term">-s, --no-splash</span>
  356.               </dt>
  357.               <dd>
  358.                 <p>Do not show the splash screen while starting.</p>
  359.               </dd>
  360.               <dt>
  361.                 <span class="term">--no-shm</span>
  362.               </dt>
  363.               <dd>
  364.                 <p>Do not use shared memory between GIMP and
  365.           plugins. </p>
  366.               </dd>
  367.               <dt>
  368.                 <span class="term">--no-cpu-accel</span>
  369.               </dt>
  370.               <dd>
  371.                 <p>Do not use special CPU acceleration
  372.           functions. Useful for finding or disabling buggy accelerated
  373.           hardware or functions.</p>
  374.               </dd>
  375.               <dt>
  376.                 <span class="term">--session=<em class="replaceable"><code>name</code></em></span>
  377.               </dt>
  378.               <dd>
  379.                 <p>
  380.             Use a different <code class="filename">sessionrc</code> for this GIMP
  381.             session. The given session name is appended to the default
  382.             <code class="filename">sessionrc</code> filename.
  383.           </p>
  384.               </dd>
  385.               <dt>
  386.                 <span class="term">--gimprc=<code class="filename">filename</code></span>
  387.               </dt>
  388.               <dd>
  389.                 <p>
  390.             Use an alternative <code class="filename">gimprc</code> instead of the
  391.             default one. The <code class="filename">gimprc</code> file contains a
  392.             record of your preferences.  Useful in cases where plugins paths
  393.             or machine specs may be different.
  394.           </p>
  395.               </dd>
  396.               <dt>
  397.                 <span class="term">--system-gimprc=<em class="replaceable"><code>filename</code></em></span>
  398.               </dt>
  399.               <dd>
  400.                 <p>Use an alternate system gimprc file</p>
  401.               </dd>
  402.               <dt>
  403.                 <span class="term">
  404.           -b, --batch=<em class="replaceable"><code>commands</code></em>
  405.         </span>
  406.               </dt>
  407.               <dd>
  408.                 <p>
  409.             Execute the set of commands non-interactively. The set of commands
  410.             is typically in the form of a script that can be executed by one
  411.             of the GIMP scripting extensions. When commands is
  412.             <strong class="userinput"><code>-</code></strong>, the commands are read from standard
  413.             input.
  414.           </p>
  415.               </dd>
  416.               <dt>
  417.                 <span class="term">--batch-interpreter=<em class="replaceable"><code>proc</code></em></span>
  418.               </dt>
  419.               <dd>
  420.                 <p>The procedure to process batch commands with</p>
  421.               </dd>
  422.               <dt>
  423.                 <span class="term">--console-messages</span>
  424.               </dt>
  425.               <dd>
  426.                 <p>
  427.             Do not popup dialog boxes on errors or warnings. Print the
  428.             messages on the console instead.
  429.           </p>
  430.               </dd>
  431.               <dt>
  432.                 <span class="term">--pdb-compat-mode=<em class="replaceable"><code>mode</code></em></span>
  433.               </dt>
  434.               <dd>
  435.                 <p>PDB compatibility mode (off|on|warn).</p>
  436.               </dd>
  437.               <dt>
  438.                 <span class="term">--stack-trace-mode=<em class="replaceable"><code>mode</code></em></span>
  439.               </dt>
  440.               <dd>
  441.                 <p>Debug in case of a crash (never|query|always)</p>
  442.               </dd>
  443.               <dt>
  444.                 <span class="term">--debug-handlers</span>
  445.               </dt>
  446.               <dd>
  447.                 <p>Enable non-fatal debugging signal
  448.           handlers. Useful for GIMP debugging.</p>
  449.               </dd>
  450.               <dt>
  451.                 <span class="term">--g-fatal-warnings</span>
  452.               </dt>
  453.               <dd>
  454.                 <p>Make all warnings fatal. Useful for debug.</p>
  455.               </dd>
  456.               <dt>
  457.                 <span class="term">--dump-gimprc</span>
  458.               </dt>
  459.               <dd>
  460.                 <p>Output a gimprc file with default
  461.           settings. Useful if you messed up the gimprc file.</p>
  462.               </dd>
  463.               <dt>
  464.                 <span class="term">--display=<em class="replaceable"><code>display</code></em></span>
  465.               </dt>
  466.               <dd>
  467.                 <p>
  468.             Use the designated X display (does not apply to all platforms).
  469.           </p>
  470.               </dd>
  471.             </dl>
  472.           </div>
  473.         </div>
  474.       </div>
  475.     </div>
  476.     <div class="navfooter">
  477.       <hr />
  478.       <table width="100%" summary="Navigation footer">
  479.         <tr>
  480.           <td width="40%" align="left"><a accesskey="p" href="gimp-introduction-whats-new.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  481.           <td width="20%" align="center">
  482.             <a accesskey="u" href="pt01.html">
  483.               <img src="../images/up.png" alt="Up" />
  484.             </a>
  485.           </td>
  486.           <td width="40%" align="right">¬†<a accesskey="n" href="gimp-concepts-setup.html"><img src="../images/next.png" alt="Next" /></a></td>
  487.         </tr>
  488.         <tr>
  489.           <td width="40%" align="left" valign="top"><a accesskey="p" href="gimp-introduction-whats-new.html">2.¬†
  490.     <span lang="en" xml:lang="en">What's New in GIMP 2.4?</span>
  491.   </a>¬†</td>
  492.           <td width="20%" align="center">
  493.             <a accesskey="h" href="index.html">
  494.               <img src="../images/home.png" alt="Home" />
  495.             </a>
  496.           </td>
  497.           <td width="40%" align="right" valign="top">¬†<a accesskey="n" href="gimp-concepts-setup.html">2.¬†
  498.     <span lang="en" xml:lang="en">Starting GIMP the first time</span>
  499.   </a></td>
  500.         </tr>
  501.       </table>
  502.     </div>
  503.   </body>
  504. </html>
  505.