4D Doc Center : PICTURE CODEC LIST

4D v13.4

PICTURE CODEC LIST


PICTURE CODEC LIST ( codecArray {; namesArray}{; *} )

Parameter	Type	Description
codecArray	String array	IDs of available picture Codecs
namesArray	String array	Names of picture Codecs
*	Operator	Return list of reading (decoding) Codecs

Description

The PICTURE CODEC LIST command fills the codecArray array with the list of picture Codec IDs that are available on the machine where it is executed. This list includes both the Codec IDs of picture formats that are managed natively by 4D v11 (see below) as well as the IDs of any additional QuickTime Codecs that are installed on the machine (see the Pictures section).

The Codec IDs can be returned in the codecArray array in three different forms:

As an extension (for example, “.gif”)
As a Mime type (for example, “image/jpeg”)
As a 4-character QuickTime code (for example, “PNTG”)

The form returned by the command will depend on the way the Codec is recorded at the operating system level. The optional namesArray array can be used to retrieve the name of each Codec. These names are more explicit than the IDs. This array can be used, for example, to build and display a menu listing the available Codecs.

By default, if you do not pass the * parameter, the command returns only the Codecs that can be used to encode (write) pictures. These IDs can be used in the format parameter of the picture export commands WRITE PICTURE FILE and PICTURE TO BLOB.
If you pass the * parameter, the command also returns the list of codecs used for decoding (reading) the pictures. The two lists are not exclusive, certain reading and writing Codecs are identical. Codecs intended for encoding pictures may usually be used for decoding. On the other hand, decoding Codecs cannot necessarily be used for encoding. For example, the ".jpg" Codec will be found in both lists, whereas the ".xbmp" Codec will only be found in the list of reading (decoding) Codecs.