wdavince – Windows Application for PDF Conversion

Version: 2.0.0

Part of DaVince Tools

Last Modified: December 13, 2001 

Command Syntax:

(Please note that the square brackets "[" and "]" specify optional parameters; do not enter the brackets as part of the command)

wdavince [file1] [file2] … [filen]

Arguments:

file1, file2, filen: Specify the name(s) of a file to be converted

 

Description

wdavince is a Windows application used for converting files to PDF. It creates a GUI interface to the "DaVince Tools" command line converters. The features of this application include:

 

Below is a screen shot of wdavince:

 

 Converter Options

Converter and Profile

Select appropriate converter and profile. This is automatically filled in with the first file added to the conversion list ("default" profile is assumed). A description of the profile is displayed if a "description" option is included in the profile.

Title, Subject, Author

The title, subject and author fields that will be filled in the newly created PDF file.

Convert: Many to 1, 1 to 1

Either combine multiple files into one PDF, or create one PDF for each file, respectively.

Include Subdirectories

Include subdirectories when converting folders.

Overwrite Existing PDF Files

Used when "1 to 1" is set, disabling this option will skip converting a file if the resulting PDF file already exists AND the PDF file date is newer than the original file date.

Open PDF After Conversion

Used when "Many to 1" is set, enabling this option will automatically launch the PDF viewer with the just converted PDF file.

Output PDF File/Output Directory

When "Many to 1" is set, "Output PDF File" specifies the PDF filename to create. If blank, the name of the PDF file will be the converter's default name. For example, "tiff.pdf" is the default name when converting TIFF files.

When "1 to 1" is set, "Output Directory" specifies where the newly created PDF files will be stored. If left blank, the PDF files will be stored in the same directory as the data file.

 

Menu Options

File Menu:

 

Save to DCF…

Save current settings to a DaVince command file. This command file can be executed later by using the "Run Command File…" menu option.

Exit

Exit the Program

Run Menu:

 

Run

Convert the specified files

Run Command File…

Execute a DaVince command file.These files can be created manually or automatically using the "Save to DCF…" menu option.

Tools Menu

This menu is customizable, which is used to launch other applications. It also may be completely removed if desired. The default installation includes menu items for tiffdump and pdfmaze.

Help Menu

 

DaVince Tools Help…

On-line help in HTML format

DaVince Home Page

Product web site

Register

Link to registration information

Install License Key…

Prompt for the license key received when registering the product and install it.

About DaVince Tools…

A dialog box displaying the version number and the registration status.

 

How to Specify Files or Directories for Conversion

There are several ways in which a file or directory can be specified for conversion:

Files and directories listed in the conversion box can be reordered by dragging and dropping them from within the same window. Files and directories can be removed from the conversion box by right clicking on them and choosing the delete option from the popup menu.

 

The output of a sample conversion appears below:

Limitations to Unregistered Version

The unregistered version of "DaVince Tools" allows full use of all program features. Unregistered copies will create an unregistered notice within the PDF file, and the Windows application will notify the user of its unregistered status after each conversion. You are encouraged to register your software by clicking on the "Register" menu item under the "Help" menu.

Customizing the Tools Menu

The Tools menu is completely customizable. It can also be removed from the application if desired. The Tools menu is defined in the wdavince.ini file. It is located in the "[toolsmenu]" section. To remove the tools menu, rename the "[toolsmenu]" name or delete the section in its entirety (for example: "[_toolsmenu]"). Below is a sample line from the "[toolsmenu]" section:

010=title:"TIFF Dump",exe:"tiffdump.exe %i",inputext:tif,input:"TIFF file(*.tif,*.tiff)|*.tif;*.tiff",params:"console,open"

The first parameter in the line ("010") specifies the ordering sequence of the item in the Tools menu. The actual value is not important, but its ordering sequence is important. The ordering sequence is based on the alphanumeric sorting sequence of the items and does not need to be sequential. Alphanumeric sorting requires leading zeros in numbers. This means a sequence value of "15" would appear before a value of "3", but not "03".

The sequence value is followed by an equals sign ("="). This is then followed by a series of comma delimited parameters used for defining the menu item. The following parameters are allowed for defining the tool menu item:

title

The title to use in the menu. Create the shortcut character by inserting an ampersand character (&) before the shortcut character. To create a separator bar in the menu, use a single dash as its title ("-")

exe

The filename of the executable file and any associated parameters. It should be located either in the "DaVince Tools" exe directory, or it should be in the path. Command line options can be specified here. If the command expects an input file to be specified, use "%i" in the command line. If the command expects an output file to be specified, use "%o" in the command line. The "%i" and "%o" options will fill in the input and output filenames on the command line by displaying the appropriate file dialog box to the user.

input

The filter definition to be used in the open dialog box.

inputext

The default file extension to be used with the input file.

output

The filter definition to be used in the save dialog box.

outputext

The default file extension when creating the output file, which is used by the save dialog box.

params

Additional comma delimited parameters that can be used to define the behavior of the tool. This item must be enclosed in quotes since it uses the same delimiter. These parameters are:

console - Run the tool in the "DaVince Tools" console window.

open - open the output file with its default viewer. For example, a PDF file will be opened by Acrobat Reader or Exchange. The "exe" paramater must include the "%o" option in order for this to work.

 

About DaVince Tools:

Visit the DaVince Tools web site at http://www.davince.com for the latest version of this software and the latest documentation. DaVince Tools is shareware and software registration is urged if you find these programs useful. You can register the software on-line at http://www.davince.com.

DaVince Tools was written in C++ using the DaVince Class Library, written by the same author as this program. The DaVince Class Library is a C++ library for developing PDF and TIFF applications. Contact the author at info@davince.com for more information on the availability of the class library.