===========================================
PDFlib for Windows Compact Embedded (WinCE)
===========================================

The package contains:

- readme.txt
- doc/                  documentation
- pdflib/               C include file and static library
- c/                    C language examples
- cpp/                  C++ language examples
- data/                 various resources required for running the examples


See doc/system-requirements.txt for a description of build and runtime
requirements.


How to start:
-------------
The "c/" and "cpp/" directories provide sample code which demonstrates how
to use PDFlib. To compile the examples for your device you'll need the
appropriate WinCE SDK for your device, providing at least compiler,
linker and the "coredll.lib", "corelibc.lib" for your device.


Compile the examples:
---------------------
C examples:
A Makefile for a nmake command line build is provided.
First you have to adjust the Makefile so that the tools/libs/includes are found.
For most of the examples you have to adjust the sample code according to the
tips you'll find later on.

C++ examples (WinCE 6.0 or newer):
Our examples use "iostream", this is only available when building from Visual
Studio. To do so you have to install an SDK for your OS Design. Once you
installed the SDK, you'll be able to create a new VS Smart Device project.
Add i.e. the <pkgdir>/cpp/hello.cpp file as source, the <pkgdir>/cpp and
the <pkgdir>/pdflib directroies have to be added as "C/C++;Additional
Include Dirctories". <pkgdir>/pdflib needs to be added to the
"Linker;Additional Library Dirctories" and "pdflib.lib" has to be added
to the "Linker;Input;Additional Dependencies" entry of the Project Properties.


Run the examples
----------------
After transfering the executables (along with the resources from the data
directory) to your device/emulator you can use the examples.
Some examples like hello.exe will work immediately. But be aware that the
resulting PDF will be written to the root directory unless you adjust the
output filename in the sample code.


Adjust the examples
-------------------
Most of the examples need some resources. As on WinCE relative paths don't
work you must adjust the sample code so that the resources can be loaded.
Depending on where you place the sample code/resources on your device/emulator
you have to tell PDFlib via the SearchPath parameter how to find them.
