function

gd_new . gd . sncode

VERSIONlatest Create a new image with GD.

GD_NEW(1e)

NAME

gd_new - Creates a new image with GD.

SYNOPSIS

gd_new (filename:"string", width:integer, height:integer, transparent:"string", format:"string", bgcolor:"string", truecolor:true|false);

DESCRIPTION

This function is used to create a new image with library GD.

To initialize a new image, you must specify a width and a height or a filename to load.

PARAMETERS

filename: Specifies the initial filename to load.

width: Specifies width of image to create.

height: Specifies height of image to create.

transparent: Specifies transparent color. Transparent color can be specified as bgcolor to use the backgound color. A color is specified as "#XXXXX" or as "255,255,255". Note that JPEG images do not support transparency, so this setting has no effect when writing JPEG images.

bgcolor: Specifies background color. A color is specified as "#XXXXX" or as "255,255,255".

format: Format of the file. This can be gif, jpg, png, gd, gd2, wbmp, xbm, xpm.

truecolor: truecolor, tells new() to create a truecolor GD::Image object. Truecolor images have 24 bits of color data (eight bits each in the red, green and blue channels respectively), allowing for precise photograph-quality color usage. If not specified, the image will use an 8-bit palette for compatibility with older versions of libgd.

RETURN

A pointer to GD structure. Will be used in other functions.

MODULES

To use this module, you must specify the following in /usr/local/website/site.conf:

Module gd {
        Library : "/usr/local/lib/libsngd.so"
        Init : "sngd_init"
}

EXAMPLES

im=gd_new(width:1000,height:1000,bgcolor:"#0000f0",truecolor:true);
im2=gd_new(filename:"/html/images/20130708-1944-londres.jpg",truecolor:true);
im3=gd_new(width:1000,height:1000,bgcolor:"#0000f0",truecolor:true);

AUTHOR

Written by Pierre Laplante and Caroline Laplante, <laplante@sednove.com>