<refentry id="reference-sgfthumbnail">

<refmeta>
<refentrytitle>sgfthumbnail</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source-name">GoGui</refmiscinfo>
<refmiscinfo class="version">GoGui &version;</refmiscinfo>
<refmiscinfo class="manual">GoGui Reference</refmiscinfo>
</refmeta>

<refnamediv>
<refname>sgfthumbnail</refname>
<refpurpose>
Create thumbnails for SGF files.
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>sgfthumbnail</command>
<arg><option>-verbose</option></arg>
<arg><option>-size</option> <replaceable>n</replaceable></arg>
<arg choice="plain">
<replaceable>input.sgf</replaceable>
</arg>
<arg><replaceable>output.png</replaceable></arg>
</cmdsynopsis>

<cmdsynopsis>
<command>sgfthumbnail</command>
<arg choice="plain"><option>-help</option></arg>
</cmdsynopsis>

<cmdsynopsis>
<command>sgfthumbnail</command>
<arg choice="plain"><option>-version</option></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsection>
<title>Description</title>
<para>
Create SGF thumbnails according to the
<ulink url="http://jens.triq.net/thumbnail-spec/index.html">
Thumbnail Managing Standard</ulink> from <ulink url="http://freedesktop.org">
freedesktop.org</ulink>.
This allows previewing the SGF files in filemanagers that support this
standard, like <ulink url="http://www.gnome.org/projects/nautilus/">
Nautilus</ulink>.
The installation script <filename>install.sh</filename> in the GoGui package
will install SgfThumbnail as a thumbnailer for the
<ulink url="http://www.gnome.org">GNOME</ulink> desktop environment.
The thumbnails will show the final position of the main variation, or the
first position that contains both black and white setup stones.
If SgfThumbnail is invoked without output filename, the thumbnails will be
created in the directory <userinput>.thumbnails/normal</userinput> in the
user home directory.
</para>
</refsection>

<refsection>
<title>Options</title>
<variablelist>

<varlistentry>
<term><option>-help</option></term>
<listitem>
<para>
Display help and exit.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-size</option> <replaceable>n</replaceable></term>
<listitem>
<para>
This option sets the maximum Thumbnail size.
Board sizes smaller than 19 will use a proportional fraction of this size.
Default is 128.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-verbose</option></term>
<listitem>
<para>
Print logging messages to standard error.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-version</option></term>
<listitem>
<para>
Print version and exit.
</para>
</listitem>
</varlistentry>

</variablelist>

<para>
<!-- Empty paragraph to enforce some space in JEditorPane (Java 1.5.0) -->
</para>
</refsection>

</refentry>
