CREATE THUMBNAIL

4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next

version 11 (Modified)


CREATE THUMBNAIL (source; dest{; width{; height{; mode{; depth}}}})

ParameterTypeDescription
sourcePicture4D picture field or variable to convert as a thumbnail
destPictureResulting thumbnail
widthIntegerThumbnail width in pixels, Default value = 48
heightIntegerThumbnail height in pixels, Default value = 48
modeIntegerThumbnail creation mode
Default value = Scaled to fit prop centered (6)
depthIntegerObsolete, do not use

Description

The CREATE THUMBNAIL command returns a thumbnail from a given source picture. Thumbnails are usually used for picture preview within multimedia software or Web sites.

Note: This command does not require QuickTime installation.

You pass in the source parameter the 4D variable or field containing the picture to reduce to a thumbnail. You pass in the dest parameter the 4D picture field or variable which should host the resulting thumbnail.

The optional parameters width and height define the required thumbnail size (in pixels). If you omit these parameters, the thumbnail default size will be 48 x 48 pixels.

The optional parameter mode defines the thumbnail creation mode, i.e. the reduction mode. Three modes are available. The following predefined constants are provided by 4D in the "Picture Display Formats" constant theme:

Constants Type Value
Scaled to fitLong integer2
Scaled to fit proportionalLong integer5
Scaled to fit prop centeredLong integer6 (default)

Note: Only these constants can be used with CREATE THUMBNAIL. The other constants in the theme "Picture Display Formats" cannot be applied to this command.

If you do not enter any parameter, the "Scaled to fit prop centered" mode (6) is applied by default. Below is an illustration of the various modes:

Source picture

Resulting thumbnails (48x48)

Scaled to fit = 2

Scaled to fit proportional = 5

Scaled to fit prop centered = 6 (default mode)

Note: With the "Scaled to fit proportional" and the "Scaled to fit prop centered", the free space will be displayed in white. When these modes are applied to picture field or variable in 4D forms, the free space is transparent.

Starting with version 11 of 4D, the depth parameter is ignored and must be omitted. The command always uses the current screen depth (number of colors).


4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next