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
  • 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 our Github repository
  • The GLDF-XSD has to be referenced by the GLDF-XML file
  • The GLDF-XSD Schema can be referenced either online (recommended) or locally inside the container
  • Referenced XSDs which differ from the official 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 contenttypes please refer to our XSD reference
    • 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

GLDF Container structure 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 specification#

The Luminaire 3D container specification is described here