.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CD-CIRCLEPRINT 1"
.TH CD-CIRCLEPRINT 1 "2021-01-05" "perl v5.32.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"
cd\-circleprint \- create a round label for a CD
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBcd-circleprint\fR [option[=value..]] \s-1FILE\s0" 4
.IX Item "cd-circleprint [option[=value..]] FILE"
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
cd-circleprint prints two round labels for CDs. It uses up to four lines of text for each
label, this is printed in arcs so the text can be much longer than if it were in straight lines.
There are four additional straight text fields for each label.
.PP
The output is in PostScript, this should work on most systems.
.PP
You can select the font, size, and colour of the text for each field separately, and you
can choose the background colour for each label. An image file in \s-1EPS\s0 format may also be used as a
background.  If you wish more complicated backgrounds
or colour effects you can save a label and modify it in any graphic program which can read
PostScript.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-config\fR" 4
.IX Item "--config"
Alternative configuration file.
.IP "\fB\-\-debug\fR" 4
.IX Item "--debug"
Enable debuggging mode, various information is printed to standard output.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Print version number and exit successfully.
.SH "LAYOUT"
.IX Header "LAYOUT"
All layout is done in PostScript, this should work on most systems.
.PP
The result of the layout are two cd-labels on one sheet of paper. On each label there are two
convex and two concave lines of text. If you have a very long line of text, you can use only
one line and make it longer.  There are no limits to the length of text.
However, after 360 degrees the ends of the text will overlap.
.PP
There are also four text fields on each label with normal horizontal
lines of text.  These text fields are specified in clockwise order:
above, right, below, and left of the central hole.
.PP
The colours are done in the RGB-model of PostScript, you can choose them for each line and 
the background of the label independently.
.PP
You can move the circles around the sheet to fit them on most types of label-sheets.
.PP
You can also squeeze or stretch the whole thing to correct small errors of your printer.
.SH "USAGE"
.IX Header "USAGE"
After starting the program you see sixteen text-entry fields divided into two blocks. 
The upper block is for the arcs, the lower block is for the straight text fields.
.PP
Each label has four text fields and four arcs.
.PP
The first two lines are for the upper arcs on the label and the last two for the lower arcs.
.PP
Write your text in the fields (support for cddb is on the \s-1TODO\s0 list)
.PP
The Save Image menu item creates a postscript file of the label.
A file selection dialogue is displayed so the user can specify the path and filename.
.PP
Font attributes and colours can be changed interactively using a dialog available from the menu.
.IP "\fBShortcuts\fR" 4
.IX Item "Shortcuts"
.Vb 4
\& Control\-l: write the label to /tmp
\& Control\-p: preview the label
\& Control\-q: quit
\& Control\-s: save the configuration
.Ve
.IP "\fBFile Menu\fR" 4
.IX Item "File Menu"
.RS 4
.PD 0
.IP "\fINew\fR" 4
.IX Item "New"
.PD
Start a new label, all label fields are cleared and parameters are reset to default values.
.IP "\fIOpen\fR" 4
.IX Item "Open"
A file selection dialog is displayed so that the user can select a label data file which is then
used to set the label values.
.IP "\fISave\fR" 4
.IX Item "Save"
The current label data values are saved using the current filename.
.IP "\fISave As\fR" 4
.IX Item "Save As"
A file selection dialog is displayed and the current label data values are saved to the file
specified by the user.
.IP "\fILoad Form Data\fR" 4
.IX Item "Load Form Data"
Load Form (Paper Layout) data from a specified file.
.IP "\fISave Form Data\fR" 4
.IX Item "Save Form Data"
Save Form Data to a specified file.
.IP "\fISave Image\fR" 4
.IX Item "Save Image"
Save an image of the labels as a specified Postscript File.
.IP "\fIPreview\fR" 4
.IX Item "Preview"
Launch the predefined preview application to preview the labels.
.IP "\fIExit\fR" 4
.IX Item "Exit"
Exit the program, all unsaved data will be lost.
.RE
.RS 4
.RE
.IP "\fBFormat Menu\fR" 4
.IX Item "Format Menu"
.RS 4
.PD 0
.IP "\fIFonts & Colours\fR" 4
.IX Item "Fonts & Colours"
.PD
Change font family, font size, font-colour and the background colour interactively, all
changes should take effect immediately in the text entry fields.
.Sp
Note, perl-tk uses the nearest match for the font. The labels may look different on your printer.
.IP "\fIAngle\fR" 4
.IX Item "Angle"
Sets the angle by which the centre of the text arcs are offset.
.IP "\fIRadii\fR" 4
.IX Item "Radii"
Specify the size of the label inner circle and the radii of the text circles.
.IP "\fIPage Deformation\fR" 4
.IX Item "Page Deformation"
Some printers do not work correctly with circles and produce an ellipse, you can squeeze or stretch
the whole page to get perfect circles with your printer.
.IP "\fIPositions\fR" 4
.IX Item "Positions"
You can move the circles around the page using this menu.
.IP "\fITop Label / Bottom Label\fR" 4
.IX Item "Top Label / Bottom Label"
Select which labels will be generated. The input fields for unselected labels are disabled.
.IP "\fITickmarks\fR" 4
.IX Item "Tickmarks"
There are many cd-label sheets on the market, so you can move the circles around the page. To make this
easier, you can print some tickmarks on the page to measure the distances.
If you have the correct values, you don't need these tickmarks any more and can save some ink.
.IP "\fICircle Boundaries\fR" 4
.IX Item "Circle Boundaries"
This allows the user to turn off the printing of the circles which show the boundaries
of the labels.
.IP "\fIGraphics\fR" 4
.IX Item "Graphics"
You can put an image on the label. This image currently has to be in eps-format.
.Sp
I thought about automatic scaling, but the program would
have to know the real size of the visible part of the graphic instead of just the bounding box.
.Sp
The scaling and shifting should be self-explanatory. The program gets the bounding box of the eps
image and puts the image in the middle of the label.
.RE
.RS 4
.RE
.IP "\fBOptions Menu\fR" 4
.IX Item "Options Menu"
.RS 4
.PD 0
.IP "\fIPreviewer\fR" 4
.IX Item "Previewer"
.PD
Select the application to use for previewing the labels.
.IP "\fIGraphics Converter\fR" 4
.IX Item "Graphics Converter"
Select the application to use for converting graphics to eps format.
.IP "\fILoad Options\fR" 4
.IX Item "Load Options"
Load program options from configuration files, this is useful to reset the configuration to a known state.
.IP "\fISave Options\fR" 4
.IX Item "Save Options"
Save the current program configuration to either the user specified configuration file
or to the default file if the user did not specify one.
.RE
.RS 4
.RE
.IP "\fBHelp Menu\fR" 4
.IX Item "Help Menu"
.RS 4
.PD 0
.IP "\fIHelp\fR" 4
.IX Item "Help"
.PD
Display this man page.
.IP "\fIAbout\fR" 4
.IX Item "About"
Display program version, description and copyright information.
.RE
.RS 4
.RE
.SH "CONFIGURATION"
.IX Header "CONFIGURATION"
You can save your configuration in a file in your \f(CW$HOME\fR or ask your sysadmin to create a global configuration-file.
.SH "FILES"
.IX Header "FILES"
There is a global configuration file /etc/cd\-circleprint.conf and a local configuration file 
\&\f(CW$HOME\fR/.cd\-circleprint.conf
.PP
You can specify a configuration file on the command line in which case the
default configuration file settings can be overridden.
For the format of the configuration files take a look at them.
Comments start with a # and blank lines are ignored.
.PP
The program sets its internal default values, looks for the global configuration file, then
for the local configuration file and finally for a user specified file.
.PP
Label data is read from a similar format file either specified on the command line
or selected from a file dialog.
.SH "BUGS"
.IX Header "BUGS"
There are probably many bugs, please fix them and send me a patch.
Thanks
.SH "AUTHORS"
.IX Header "AUTHORS"
cd-circleprint is written and maintained by Colin Tuckley <colintu@users.sourceforge.net>
cd-circleprint was originally written by Matthias Kabel <matthias.kabel@tyche.de>
.PP
You can find the latest version at http://cd\-circle\-print.sourceforge.net
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
Thanks to sourceforge.net for hosting free software