Skip to main content

GLDF Container Specification

General

  • The container files' underlying format is a standard ZIP archive
  • The container file extension is .gldf

Root folder content

In the root of the container file the following elements are expected

Mandatory

  • GLDF-XML file, with the file name product.xml

Optional

  • GLDF-XSD Schema file, with the filename gldf.xsd
  • Multiple directories for assets like photometries, images, geometry files and other
  • signature file, without extension. Intended for a digital signature of the content above

GLDF-XML file

  • Filename
    • The filename of the GLDF XML inside the root directory must be product.xml
  • The GLDF-XML file is expected to be valid as follows
    • Valid XML syntax
    • Valid against the referenced gldf.xsd, see below
  • Invalid XMLs files may not be parsed and lead to errors

GLDF-XSD Schema

  • The official GLDF-XSD Schema can always be found published on gldf.io or our Github repository
  • The GLDF-XSD has to be referenced by the GLDF-XML file
  • The GLDF-XSD Schema can be referenced either online or locally inside the container
  • Referenced XSDs which differ from the officially published XSDs may lead to errors. Please use only the published XSDs for validation and development

Directories

  • The root directory may contain further directories
  • These directories can contain assets like images, photometries, spectrums, 3d models or documents
  • Directory names
    • The directory name must reflect the first part of the contentType of the files it contains
    • For possible content types please refer the Files documentation
    • Examples
      • The contenttype for JPG images is image/jpg. The directory name for this asset must be image
      • The contenttype for PNG images is image/png. The directory name for this asset must be image
      • The contenttype for Eulumdat photometries is ldc/eulumdat. The directory name for this asset must be ldc
      • The contenttype for IES photometries is ldc/ies. The directory name for this asset must be ldc

Container example

For a manufacturer with the name ManufacturerXY and a luminaire with the name Pendulum 50W LED, the GLDF file content could have the following structure:

    ManufacturerXY-Pendulum-50W-LED.gldf
|—— product.xml
|—— signature
|—— image/
| |—— productimage.jpg
| |—— familyimage.jpg
|—— ldc/
| |—— lightsource-photometry.ldt
| |—— luminaire-photometry.ldt
|—— geo/
| |—— luminaire-3d-model.l3d
|—— document/
| |—— luminaire-manual.pdf
|—— spectrum/
| |—— lightsource-spectrum.txt

L3D Container

The Luminaire 3D container specification is described here