char* cdVersion(void); [in C]

cd.Version() -> (version: string) [in Lua]

Returns the current version number of the library. The string with the version number has a format "". For instance, the string "2.1.3" has number 2 as the main (major) version number, 1 as the secondary (minor) version number, and 3 as the build number. The major version number represents a change in the structure or behavior of functions; the minor version number represents one or more new drivers and functions added to the library; and the build version number represents one or more corrected bugs.

char* cdVersionDate(void); [in C]

cd.VersionDate() -> (versiondate: string) [in Lua]

Returns the release date of the current version of the library.

int cdVersionNumber(void); [in C]

cd.VersionNumber() -> (version: number) [in Lua]

Returns the current version number of the library.

[in C]
CD_NAME           "CD - Canvas Draw"
CD_DESCRIPTION    "A 2D Graphics Library"
CD_COPYRIGHT      "Copyright (C) 1994-2007 Tecgraf/PUC-Rio and PETROBRAS S/A"
CD_VERSION        "5.0"
CD_VERSION_DATE   "2007/04/09"

[in Lua]

Useful definitions. They have the same value returned by cdVersion* functions, except that they do not include the build number.

Metafile Interpretation

int cdCanvasPlay(cdCanvas* canvas, cdContext* ctx, int xmin, int xmax, int ymin, int ymax, void *data); [in C]
int wdCanvasPlay(cdCanvas* canvas, cdContext* ctx, double xmin, double xmax, double ymin, double ymax, void *data); (WC) [in C]

canvas:Play(ctx, xmin, xmax, ymin, ymax: number, data: string) -> (status: number) [in Lua]
canvas:wPlay(ctx, xmin, xmax, ymin, ymax: number, data: string) -> (status: number) [in Lua]

Interprets the graphical contents (primitives and attributes) in a given driver and calls equivalent functions of the CD library using the given canvas. The primitives are drawn inside the region defined by the given limits. If limits are 0 (xmin, xmax, ymin and ymax) the primitives will be drawn with their coordinates having the original values in the file. The WD version will simply use the given limits in World Coordinates (since 5.9).

Returns CD_OK or CD_ERROR.

Only some drivers implement this function:

int cdContextRegisterCallback(cdContext *ctx, int cb, int(*func)(cdCanvas* canvas, ...)); [in C]

cd.ContextRegisterCallback(ctx, cb: number, func: function) -> (status: number) [in Lua]

Used to customize the behavior of the  Play function. If you register a known callback function, it will be called during the processing loop of cdCanvasPlay. Returns CD_OK if the specified callback is supported or CD_ERROR otherwise.

The callback itself should return CD_CONTINUE, if it returns CD_ABORT, the cdPlay function is aborted. The callback identifiers of a given driver must be in the header file relative to that driver, with prefix "CD_XXYYYCB", where XX identifies that driver and YYY identifies the callback name.

There is a default callback common to all implementations of cdPlay, CD_SIZECB. Its definition is:

int cdResizeCB(cdCanvas* canvas, int width, int height, double mm_width, double mm_height)

It returns the size of the image in the file before any function in the CD library is called, so that you can call the  cdPlay function without an active canvas and create the canvas inside the callback. Its values are the same as returned by the  cdCanvasGetSize function.