Skip to main content
Version: 20 R7 BETA

CREATE THUMBNAIL

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.

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 resizing mode. Three modes are available. The following predefined constants are provided by 4D in the “Picture Display Formats” constant theme:

ConstantTypeValue
Scaled to fitInteger2
Scaled to fit prop centeredInteger6
Scaled to fit proportionalInteger5

Note: Only these constants can be used with CREATE THUMBNAIL. The other constants in this theme 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.

The depth parameter is ignored and must be omitted. The command always uses the current screen depth (number of colors).

Properties

Command number679
Thread safe