.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Games::Go::Sgf2Dg::Dg2TeX 3pm"
.TH Games::Go::Sgf2Dg::Dg2TeX 3pm "2019-10-27" "perl v5.30.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Games::Go::Sgf2Dg::Dg2TeX \- convert Games::Go::Sgf2Dg::Diagrams to TeX
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
use Games::Go::Sgf2Dg::Dg2TeX
.PP
.Vb 2
\& my $dg2tex = B<Games::Go::Sgf2Dg::Dg2TeX\-E<gt>new> (options);
\& my $tex = $dg2tex\->convertDiagram($diagram);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
A Games::Go::Sgf2Dg::Dg2TeX object converts a Games::Go::Sgf2Dg::Diagram object
into TeX source code which can be used stand-alone, or it can be
incorporated into larger TeX documents.
.SH "NEW"
.IX Header "NEW"
.ie n .IP "my $dg2tex = \fBGames::Go::Sgf2Dg::Dg2TeX\->new\fR (?options?)" 4
.el .IP "my \f(CW$dg2tex\fR = \fBGames::Go::Sgf2Dg::Dg2TeX\->new\fR (?options?)" 4
.IX Item "my $dg2tex = Games::Go::Sgf2Dg::Dg2TeX->new (?options?)"
.PP
A \fBnew\fR Games::Go::D2TeX takes the following options:
.IP "\fBboardSizeX\fR => number" 8
.IX Item "boardSizeX => number"
.PD 0
.IP "\fBboardSizeY\fR => number" 8
.IX Item "boardSizeY => number"
.PD
Sets the size of the board.
.Sp
Default: 19
.IP "\fBdoubleDigits\fR => true | false" 8
.IX Item "doubleDigits => true | false"
Numbers on stones are wrapped back to 1 after they reach 100.
Numbers associated with comments and diagram titles are not
affected.
.Sp
Default: false
.IP "\fBtopLine\fR     => number (Default: 1)" 8
.IX Item "topLine => number (Default: 1)"
.PD 0
.IP "\fBbottomLine\fR  => number (Default: 19)" 8
.IX Item "bottomLine => number (Default: 19)"
.IP "\fBleftLine\fR    => number (Default: 1)" 8
.IX Item "leftLine => number (Default: 1)"
.IP "\fBrightLine\fR   => number (Default: 19)" 8
.IX Item "rightLine => number (Default: 19)"
.PD
The edges of the board that should be displayed.  Any portion of the
board that extends beyond these numbers is not included in the
output.
.ie n .IP "\fBdiaCoords\fR => sub { # convert $x, $y to Games::Go::Sgf2Dg::Diagram coordinates }" 8
.el .IP "\fBdiaCoords\fR => sub { # convert \f(CW$x\fR, \f(CW$y\fR to Games::Go::Sgf2Dg::Diagram coordinates }" 8
.IX Item "diaCoords => sub { # convert $x, $y to Games::Go::Sgf2Dg::Diagram coordinates }"
This callback defines a subroutine to convert coordinates from \f(CW$x\fR,
\&\f(CW$y\fR to whatever coordinates are used in the Games::Go::Sgf2Dg::Diagram
object.  The default \fBdiaCoords\fR converts 1\-based \f(CW$x\fR, \f(CW$y\fR to the
same coordinates used in \s-1SGF\s0 format files.  You only need to define
this if you're using a different coordinate system in the Diagram.
.Sp
Default:
    sub { my ($x, \f(CW$y\fR) = \f(CW@_\fR;
          \f(CW$x\fR = chr($x \- 1 + ord('a')); # convert 1 to 'a', etc
          \f(CW$y\fR = chr($y \- 1 + ord('a'));
          return(\*(L"$x$y\*(R"); },           # concatenate two letters
.Sp
See also the \fBdiaCoords\fR method below.
.ie n .IP "\fBfile\fR => 'filename' | $descriptor | \e$string | \e@array" 8
.el .IP "\fBfile\fR => 'filename' | \f(CW$descriptor\fR | \e$string | \e@array" 8
.IX Item "file => 'filename' | $descriptor | $string | @array"
If \fBfile\fR is defined, the TeX source is dumped into the target.
The target can be any of:
.RS 8
.IP "filename" 4
.IX Item "filename"
The filename will be opened using IO::File\->new.  The filename
should include the '>' or '>>' operator as described in 'perldoc
IO::File'.  TeX source is written into the file.
.IP "descriptor" 4
.IX Item "descriptor"
A file descriptor as returned by IO::File\->new, or a \e*FILE
descriptor.  TeX source is written into the file.
.IP "reference to a string scalar" 4
.IX Item "reference to a string scalar"
TeX source is concatenated to the end of the string.
.IP "reference to an array" 4
.IX Item "reference to an array"
TeX source is split on \*(L"\en\*(R" and each line is pushed onto the array.
.RE
.RS 8
.Sp
Default: undef
.RE
.ie n .IP "\fBprint\fR => sub { my ($dg2tex, @tex) = @_; ... }" 8
.el .IP "\fBprint\fR => sub { my ($dg2tex, \f(CW@tex\fR) = \f(CW@_\fR; ... }" 8
.IX Item "print => sub { my ($dg2tex, @tex) = @_; ... }"
A user defined subroutine to replace the default printing method.
This callback is called from the \fBprint\fR method (below) with the
reference to the \fBDg2TeX\fR object and a list of lines that are
part of the TeX diagram source.
.IP "\fBsimple\fR => true | false" 8
.IX Item "simple => true | false"
This generates very simple TeX which may not look so good on the page,
but is convenient if you intend to edit the TeX.
.Sp
Default: false
.IP "\fBtwoColumn\fR => true | false" 8
.IX Item "twoColumn => true | false"
This generates a two-column format using smaller fonts. This
option forces \fBsimple\fR true.
.Sp
Default: false
.IP "\fBcoords\fR => true | false" 8
.IX Item "coords => true | false"
Adds coordinates to right and bottom edges.
.Sp
Default: false
.IP "\fBbigFonts\fR => true | false" 8
.IX Item "bigFonts => true | false"
Use fonts magnified 1.2 times.
.Sp
Default: false
.IP "\fBtexComments\fR => true | false" 8
.IX Item "texComments => true | false"
Certain characters, when found in comments, are normally remapped as
follows:
.Sp
.Vb 10
\&    \e   =>  $\ebackslash$
\&    {   =>  $\elbrace$
\&    }   =>  $\erbrace$
\&    $   =>  \e$
\&    &   =>  \e&
\&    #   =>  \e#
\&    ^   =>  $\ewedge$
\&    _   =>  \e_
\&    %   =>  \e%
\&    ~   =>  $\esim$
\&    <   =>  $<$
\&    >   =>  $>$
\&    |   =>  $|$
.Ve
.Sp
(see the TeX Book page 38).  When \fBtexComments\fR is specified, the mappings
are suppressed so you can embed normal TeX source (like {\ebf change fonts})
directly inside the comments.
.IP "\fBfloatControl\fR => controls which side diagrams will float on" 8
.IX Item "floatControl => controls which side diagrams will float on"
\&\fBfloatControl\fR is a string that controls which side diagrams floats on.
An 'l' puts the diagram on the left side (text on the right), 'r' puts the
diagram on the right side, 'a' alternates, and any other character places
the diagram randomly.  The first character is for the first diagram, second
character is for the second diagram, and so on. When there is only one
character left, that character controls all remaining diagrams.
.Sp
\&\fBfloatControl\fR is used only during 'normal' formatting.  It is not used
with 'simple' or 'twoColumn' formats.
.Sp
Default: 'rx'    # first diagram on the right, all others are random
.Sp
Default: 12
.SS "Interactions between options"
.IX Subsection "Interactions between options"
If \fBtwoColumn\fR is true, \fBsimple\fR is turned on (no warning).
.SH "METHODS"
.IX Header "METHODS"
.ie n .IP "$dg2tex\->\fBconfigure\fR (option => value, ?...?)" 4
.el .IP "\f(CW$dg2tex\fR\->\fBconfigure\fR (option => value, ?...?)" 4
.IX Item "$dg2tex->configure (option => value, ?...?)"
Change Dg2TeX options from values passed at \fBnew\fR time.
.ie n .IP "my $coord = $dg2mp\->\fBdiaCoords\fR ($x, $y)" 4
.el .IP "my \f(CW$coord\fR = \f(CW$dg2mp\fR\->\fBdiaCoords\fR ($x, \f(CW$y\fR)" 4
.IX Item "my $coord = $dg2mp->diaCoords ($x, $y)"
Provides access to the \fBdiaCoords\fR option (see above).  Returns
coordinates in the converter's coordinate system for board coordinates ($x,
\&\f(CW$y\fR).  For example, to get a specific intersection structure:
.Sp
.Vb 1
\&    my $int = $diagram\->get($dg2mp\->diaCoords(3, 4));
.Ve
.ie n .IP "$dg2tex\->\fBprint\fR ($tex ? , ... ?)" 4
.el .IP "\f(CW$dg2tex\fR\->\fBprint\fR ($tex ? , ... ?)" 4
.IX Item "$dg2tex->print ($tex ? , ... ?)"
\&\fBprint\fRs raw TeX code to \fBfile\fR as defined at \fBnew\fR time.
Whether or not \fBfile\fR was defined, \fBprint\fR accumulates the TeX
code for later retrieval with \fBconverted\fR.
.ie n .IP "my $tex = $dg2tex\->\fBconverted\fR ($replacement_tex)" 4
.el .IP "my \f(CW$tex\fR = \f(CW$dg2tex\fR\->\fBconverted\fR ($replacement_tex)" 4
.IX Item "my $tex = $dg2tex->converted ($replacement_tex)"
Returns the TeX source code converted so far for the \fBDg2TeX\fR
object.  If \f(CW$replacement_tex\fR is defined, the accumulated TeX source
code is replaced by \f(CW$replacement_tex\fR.
.ie n .IP "$dg2tex\->\fBcomment\fR ($comment ? , ... ?)" 4
.el .IP "\f(CW$dg2tex\fR\->\fBcomment\fR ($comment ? , ... ?)" 4
.IX Item "$dg2tex->comment ($comment ? , ... ?)"
Inserts the TeX comment character ('%') in front of each line of
each comment and \fBprint\fRs it to \fBfile\fR.
.ie n .IP "my $tex_source = $dg2tex\->\fBconvertDiagram\fR ($diagram)" 4
.el .IP "my \f(CW$tex_source\fR = \f(CW$dg2tex\fR\->\fBconvertDiagram\fR ($diagram)" 4
.IX Item "my $tex_source = $dg2tex->convertDiagram ($diagram)"
Converts a \fIGames::Go::Sgf2Dg::Diagram\fR into TeX.  If \fBfile\fR was defined
in the \fBnew\fR method, the TeX source is dumped into the \fBfile\fR.
In any case, the TeX source is returned as a string scalar.
.ie n .IP "my $tex = $dg2tex\->\fBconvertText\fR ($text)" 4
.el .IP "my \f(CW$tex\fR = \f(CW$dg2tex\fR\->\fBconvertText\fR ($text)" 4
.IX Item "my $tex = $dg2tex->convertText ($text)"
Converts \f(CW$text\fR into TeX code by changing certain characters that are
not available in TeX cmr10 font, and by converting \en\en into
\&\ehfil\ebreak.  \fBconvertText\fR behavior is modified by \fBtexComments\fR
and \fBsimple\fR options.
.Sp
Returns the converted text.
.ie n .IP "$dg2tex\->\fBclose\fR" 4
.el .IP "\f(CW$dg2tex\fR\->\fBclose\fR" 4
.IX Item "$dg2tex->close"
\&\fBprint\fR the TeX closer (\ebye) and close the dg2tex object.  Also
closes \fBfile\fR if appropriate.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "sgf2dg(1)" 4
.IX Item "sgf2dg(1)"
Script to convert \s-1SGF\s0 format files to Go diagrams
.SH "BUGS"
.IX Header "BUGS"
Nah.  At least, I don't think so.  Well, I hope not.