News Shareware IServices Freeware Projects Partnerships
jpg2pdf ©

developed by SANFACE Software ©

Version 2.4 25th April 2002

Contents

Try also jpg2pdf PRO and txt2pdf

SANFACE Software logo
What is jpg2pdf?

jpg2pdf is a very flexible and powerful PERL5 program. It can convert a collection of jpeg images into a unique PDF.
You can use jpg2pdf like a module inside your applications (cgis, ...).

Why do you need jpg2pdf?

Getting jpg2pdf, Licence and Registration

jpg2pdf is shareware
The jpg2pdf source code is our company core business.
We trust you.
You can freely redistribute (without modify it) jpg2pdf tool in its unregistered archive format (zip or tar.gz)

You can't use a modify version of jpg2pdf for production purpose.
You can't resell jpg2pdf or a modify version of it without SANFACE Software authorization.
You can't copy part of it to include in your source without SANFACE Software authorization.

The jpg2pdf sorce code tar.gz (last 2.x version)
The jpg2pdf source code zipped (last 2.x version)

We like PERL and we distribute jpg2pdf in perl source code.
Probably you don't like it or you don't want to install it or ...
The jpg2pdf self extracting Windows version (last 2.x version)
The jpg2pdf Windows version (last 2.x version)
The jpg2pdf Solaris version (last 2.x version)
The jpg2pdf HP-UX version (last 2.x version)
The jpg2pdf Linux version (last 2.x version)
The jpg2pdf AIX version (last 2.x version)
The jpg2pdf Mac OS X version (last 2.x version)

Please note that the Windows version comes with an extra tool known as Visual jpg2pdf.

jpg2pdf 2.4 is shareware. The registration fee is $65 (US) every installation.

Register jpg2pdf at SWREG

If you're a developer or a software house and you're interested to use jpg2pdf inside your tools these're our standard economical policies. In every case we suggest you to contact directly us. We're a small company and we're interested to find economical agreement.

VOLUME DISCOUNT
4-10$55 each
11 or more$35 each

NO LIMIT LICENCE
You've one or more products with a lot of installations and you want to put jpg2pdf inside every your tool. This is the licence you're looking for.
Its costs: $2000 + 20 % every year. Obviously you'll receive every update freely.

Installing jpg2pdf

  1. Create a new directory (e.g. jpg2pdf)
  2. We distribute jpg2pdf in 2 formats: .zip and .tar.gz
    With the file .zip you can use a lot of tools to unzip it and put all the files inside the new directory you've created
    With .tar.gz on Windows you can use Winzip, on unix you can use gunzip + tar commands or directly GNU tar with option z (e.g. tar zxvf jpg2pdf.tar.gz)
  3. test if the executable version works correctly:
    ./jpg2pdf -h (on Windows .\jpg2pdf -h)
    With the perl version in every OS you can use:
    perl jpg2pdf.pl -h (on Unix if your perl path is /usr/bin/perl you can use simply jpg2pdf.pl -h)
    The result is simply a minimal help
  4. create your first PDF on the fly:
    With the executables version
    ./jpg2pdf yourjpeg.jpg (on Windows .\jpg2pdf yourjpeg.jpg)
    With the perl version in every OS you can use:
    perl jpg2pdf.pl yourjpeg.jpg
    The default result is jpegs.pdf
Configuring jpg2pdf
  1. jpg2pdf use like configuration file jpg2pdf.cfg. jpg2pdf looks for jpg2pdf.cfg in the directory where jpg2pdf is located
  2. Create your personal jpg2pdf.cfg file.
    You can change the value of author, creator, keywords, subject, title, paper, transition, pagemode, pagelayout, scale, bgdesign, fgdesign, imagex, imagey and list variables.
    To change the deafult value of these parameters you need to edit jpg2pdf.cfg or create a different file using the same syntax (to use a configuration file different from the default jpg2pdf.cfg you can use the option -configure yourconfigfile.cfg)
    With author, creator, keywords, subject, title you can set the relative fields of PDF Info dictionary that provides information about the document.
    AuthorThe name of the person who created the document
    CreatorIf the document was converted into a PDF document from another form, this is the name of the application that created the original document
    KeywordsKeywords associated with the document
    SubjectThe subject of the document
    TitleThe document's title
    If the value of author, creator, keywords, subject is not known there are omitted.
    The default paper value is letter. You can use also A3 (or a3), A4 (or a3), A5 (or a5), tabloid, ledger, legal, statement, executive and image
    image means that every page has the format of the image put inside.
    With transition variable you can use these parameters: Note: PDF format supports only the described transition values
    With pagemode variable you can use these parameters:
    FullScreen: the Acrobat Reader will open your document in full-screen mode. In full-screen mode, there is no menu bar, window controls, nor any other window present.
    UseThumbs: thumbnail page images should be displayed automatically
    The default pagelayout value is single page. You can use OneColumn (Display the pages in one column), TwoColumnLeft (Display the pages in two columns, with odd-numbered pages on the left), TwoColumnRight (Display the pages in two columns, with odd-numbered pages on the right)
    With scale you can set the scale factor for your images. The default is 1 (no scale). You can use e.g. 1.5, 0.25 ...
    With bgdesign and fgdesign you can set a background or foreground file. Inside you can use directly PDF syntax.
    With imagex you can set the left margin (the distance of the image from the left margin of the page) and with imagey the bottom margin (the distance of the image from the bottom margin of the page)
    list : file inside list file you can put a list of your input textual reports (one every line) using absolute or relative path
  3. Inside bgdesign and fgdesign files you can use directly the PDF syntax to design and to write
    These are a few examples:
    If you want to put on every generated page a bold big diagonal DRAFT, you can use the foreground file with
    REMBER to put the text instruction inside BT and ET

          BT
          /F3 55 Tf
          .5 .5 -.5 .5 150 455 Tm
          (DRAFT) Tj
          ET
    
    /F3 means use the bold Courier font, 55 is the point size.
    The meaning of the first line is: use the bold selected font with point size 55.
    The meaning of the second line is: start form point (150,455) and write diagonal.
    The meaning of the third line is: write DRAFT.
    You can use these 14 PDF default fonts: If you want to design like background a border line black inside grey, you can use the background file with
          .9 g
          0 G
          3 w
          25 25 545 792 re
          B
    
    The meaning of the first line is: inside the rectangle use grey (0 is black, 1 is white)
    The meaning of the second line is: the line is black
    The meaning of the third line is: the width of the line is 3
    The meaning of the fourth line is: the rectangle is (25,25) (545,792)
    The meaning of the fiveth line is: design

    You can find the information about the PDF syntax you can use in the layers directly in The PDF Reference Manual Version 1.3 second edition PDF (696 pages, ~5 Mb) in the Chapter 4 and 5 (Page Descriptions).
  4. Try to start jpg2pdf. Enter in Tests directory and digit:
    ../jpg2pdf -c test.cfg *.jpg
    jpges.pdf is the PDF output file
Syntax

jpg2pdf [-options] files
where options include:
    -help                        print out this message
    -output    file              default jpegs.pdf
    -configure file              default jpg2pdf.cfg
    -list file                   a list of textual input files
    -recursive directory         scan recursively the directory
    -match     files             match different files ex. *.pdf, a?.*
                                 (require -recursive option)
    -verbose                     verbose

list:
    with list you can use metacharacters and relative and absolute path name
Other Features

Multiuser Features

A system manager can install jpg2pdf and provide a default .cfg file for his users/organization

setenv JPG2PDFCFG /wherever/default.cfg Unix in csh.cshrc for example
define/system JPG2PDF wherever:default.cfg VMS in SYLOGIN.COM for example
A user can still overwrite the value using another setenv or define command in his own .cshrc/login.com if he wants to have a default file of his own.
A user can still have a working directory with a jpg2pdf.cfg file and have it loaded if exists. This allows him (without command line option) to setup fully functional working directories.
He can also (as he wishes) use the -configure option to overwrite any defaults.

What's new in this version

Here you can find an exhaustive history file

jpg2pdf is a trademark of SANFACE Software© 2002.
Your technology glasses. We help you see your full potential.
mailto:sanface@sanface.com WAP http://www.sanface.com/wap/
http://www.sanface.com I-mode http://www.sanface.com/i/

News Shareware IServices Freeware Projects Partnerships