Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 96

Tables

Page 96 of 839

The default color space for all object types is DeviceRGB. Images should normally be inserted in the

native image color space. This can be achieved by setting the flag tfUseImageCS. The flag is inherited

from the table, columns, and rows as usual. See SetFlags() for further information.

The color space for images can be set with SetColor() and SetColorEx(). The color value is only used

for 1 bit images. If an image color is defined and if the image is a 1 bit image then it will be output as

an image mask. In this case, non-zero pixel values are drawn in the defined image color and zero

pixel values produce no output.

If no image color is defined then 1 bit images are drawn as opaque black & white image.

Table Creation

A table can be created with the function CreateTable() in C or C++. All other interfaces contain the

table class CPDFTable or TPDFTable in Delphi which encapsulates the table functions into a native

class object. The class name is dynatable in PHP.

The constructor takes the number of rows which should be allocated, as well as the number of

columns and the default row height.

Since VB 6 does not support parameterized constructors, the function CreateTable() must be

called after creating the class instance.

The number of pre-allocated rows should be large enough to avoid unnecessary memory re-

allocations. Note that this is just the size of the array that holds the rows which will be added later.

An unused row requires 4 or 8 bytes memory (32 or 64 bit).

The constructor does not allocate rows. The first chunk will be allocated when the first row is added.

C/C++ deveopers must delete a table object when no longer needed with DeleteTable(). The

destructor of the class CPDFTable calls this function automatically in other programming languages

when the class instance will be deleted.

In programming languages which use reference counting like PHP or VB 6, it is very important to

delete tables and the associated PDF instance in the right order, especially if a table contains

references of other tables. This is the case when a sub table was inserted into a cell.

Delete first all tables which contain references of other tables and delete finally the sub tables. This

makes sure that the reference count reaches zero when trying to release the class instance.

Tables must also be deleted before the associated PDF instance will be deleted since a table contains

a reference of this PDF instance! These rules must be carefully considered to avoid memory leaks.

Although it is not required to delete tables in the right order in C or C++ or Delphi, it is best practice

to do so.