NAME

       cd-circleprint - create a round label for a CD

SYNOPSIS

       cd-circleprint [option[=value..]] FILE

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.

       The output is in PostScript, this should work on most systems.

       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 EPS 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.

OPTIONS

       --config
           Alternative configuration file.

       --debug
           Enable debuggging mode, various information is printed to standard output.

       --version
           Print version number and exit successfully.

LAYOUT

       All layout is done in PostScript, this should work on most systems.

       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.

       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.

       The colours are done in the RGB-model of PostScript, you can choose them for each line and
       the background of the label independently.

       You can move the circles around the sheet to fit them on most types of label-sheets.

       You can also squeeze or stretch the whole thing to correct small errors of your printer.

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.

       Each label has four text fields and four arcs.

       The first two lines are for the upper arcs on the label and the last two for the lower
       arcs.

       Write your text in the fields (support for cddb is on the TODO list)

       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.

       Font attributes and colours can be changed interactively using a dialog available from the
       menu.

       Shortcuts
            Control-l: write the label to /tmp
            Control-p: preview the label
            Control-q: quit
            Control-s: save the configuration

       File Menu
           New Start a new label, all label fields are cleared and parameters are reset to
               default values.

           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.

           Save
               The current label data values are saved using the current filename.

           Save As
               A file selection dialog is displayed and the current label data values are saved
               to the file specified by the user.

           Load Form Data
               Load Form (Paper Layout) data from a specified file.

           Save Form Data
               Save Form Data to a specified file.

           Save Image
               Save an image of the labels as a specified Postscript File.

           Preview
               Launch the predefined preview appplication to preview the labels.

           Exit
               Exit the program, all unsaved data will be lost.

       Format Menu
           Fonts & Colours
               Change font family, font size, font-colour and the background colour
               interactively, all changes should take effect immediately in the text entry
               fields.

               Note, perl-tk uses the nearest match for the font. The labels may look different
               on your printer.

           Angle
               Sets the angle by which the centre of the text arcs are offset.

           Radii
               Specify the size of the label inner circle and the radii of the text circles.

           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.

           Positions
               You can move the circles around the page using this menu.

           Top Label / Bottom Label
               Select which labels will be generated. The input fields for unselected labels are
               disabled.

           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.

           Circle Boundaries
               This allows the user to turn off the printing of the circles which show the
               boundaries of the labels.

           Graphics
               You can put an image on the label. This image currently has to be in eps-format.

               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.

               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.

       Options Menu
           Previewer
               Select the application to use for previewing the labels.

           Graphics Converter
               Select the application to use for converting graphics to eps format.

           Load Options
               Load program options from configuration files, this is useful to reset the
               configuration to a known state.

           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.

       Help Menu
           Help
               Display this man page.

           About
               Display program version, description and copyright information.

CONFIGURATION

       You can save your configuration in a file in your $HOME or ask your sysadmin to create a
       global configuration-file.

FILES

       There is a global configuration file /etc/cd-circleprint.conf and a local configuration
       file $HOME/.cd-circleprint.conf

       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.

       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.

       Label data is read from a similar format file either specified on the command line or
       selected from a file dialog.

BUGS

       There are probably many bugs, please fix them and send me a patch.  Thanks

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>

       You can find the latest version at http://cd-circle-print.sourceforge.net

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       Thanks to sourceforge.net for hosting free software