Stoatworks Labs

Reference

GLL files, and what EASE Focus does with them

A GLL is the file that puts a manufacturer's loudspeaker into AFMG's modelling programs: EASE, EASE Focus, EASE Address and their relatives. It carries the box's shape, the directivity of every driver in it, the filters, the rigging and the limits, compiled into a closed binary from a project only the manufacturer keeps. EASE Focus costs you nothing. The GLLs cost the manufacturer, per model, which explains more about what is and isn't in the list than anything technical does.

What's inside one

AFMG replaced a table with an object model, and that's most of the story. The old EASE format described every loudspeaker, however many drivers and amplifiers it had, as one point source with one balloon. A GLL starts from a box type: a cabinet with its geometry, weight and centre of gravity, a set of acoustic sources placed and aimed inside it, and the inputs and filter groups that feed them. The bigger objects are built out of box types.

ObjectWhat it addsIn EASE Focus
Box typeCabinet geometry, weight, centre of gravity. Sources, each with a position, an orientation, a directivity balloon, sensitivity, rated bandwidth and a maximum input voltage. Inputs, mapped to filter groups: crossovers, user adjustments, DSP presets.The building block
Loudspeaker (LS)One box type, used on its own or in multiples.Yes
Cluster (CL)Fixed setups of one or more box types, and optionally setups the user builds from those types.No
Line array (LA)Box types hung in rigging frames and joined by connectors, with the limits and warnings the manufacturer sets.Yes
Angular resolution1° to 90°Meridians; parallels 1° to 45°. SpeakerLab guide §2.7.2.1
Frequency points1/24 octaveHigh-resolution sources. Tabular sources at 1/3 or 1/1. §8.5.5, §2.7.10
PhaseKeptFrom impulse or complex response, with propagation delay stored apart
Impulse length8,192 pointsThe minimum AES56 recommends, quoted in §2.7.1
Symmetry5 kindsNone, horizontal, vertical, quarter, axial. §2.7.2.2
Output limitVolts, not wattsProgram Vrms over one minute. §2.7.4.4
Range in Focus20 Hz–20 kHzEASE Focus 3 guide §1.1
Not modelledDiffractionNor shadowing, mutual coupling or boundary loading. White paper
  • Maximum output is a voltage. Maximum SPL comes from the measured sensitivity, the spectrum of the signal you pick at calculation time, and the source's Program Vrms (1 minute) rating. The Peak (1 s) and Continuous (100 h) voltages are stored too, and SpeakerLab labels them information only. So the manufacturer's choice of that one voltage sets every max-SPL figure you'll see, which matters later.
  • Phase is kept, and the time of flight is taken out of it. The propagation delay to each measurement point is stored separately, which flattens the phase slope and lets 1/24-octave spacing describe it further up the band than it otherwise could. Phase is what makes two boxes interfere properly in a prediction, and it's the thing the old format didn't have per driver.
  • What you can change is up to the author. The project decides which parameters the end user sees: splay angles, box counts and mixes, filter settings, input configurations. A line array in a GLL can only be reconfigured as far as its manufacturer allowed, which is why two GLLs for similar boxes can behave very differently in Focus.

How one gets made

Measure every source. The box goes on a turntable or a robot arm and each source is measured over a sphere, as impulse responses on a grid of meridians and parallels. SpeakerLab finds the files by name: IR030010 is meridian 30°, parallel 10°. Every meridian includes the on-axis point and the one straight behind, and the repeated on-axis measurement is used to correct drift in the room while the rotation runs.

AFMG's white paper asks for the far field (roughly ten times the source's characteristic size), each separately filtered source measured about its own rotation point, and a line array cabinet measured with its neighbours in place, because the format has no diffraction model to put them back afterwards.

Build and compile. In SpeakerLab the manufacturer assembles the box types, sources, filters and rigging into a project, an .xgll, and compiles it to the .gll that gets distributed. The project is the source code and never needs to leave the building.

Authorise. AFMG supply an .author file, encrypted for one model, that's compiled into the GLL. EASE will load a GLL without one and mark it as not authorised. EASE Focus and EASE Address won't load it at all, and for those two the authorisation is something the manufacturer buys.

Presets travel as .xglc configuration files: plain text holding the filter, input and setup settings for one GLL, embedded in it by the author. You can save your own in SpeakerLab or the GLL Viewer, and since Focus 3.1.310 load them into a line array in Focus.

FileWhat it is
.gllThe compiled GLL. A closed binary, and the file you get given.
.xgllThe SpeakerLab project the GLL is compiled from. The source code, which stays with whoever wrote it.
.xglcA configuration: filter, input and setup settings, as text. Manufacturer presets are these, embedded in the GLL.
.authorAFMG’s authorisation file, encrypted for one model and compiled in. Without it the data shows as not authorised.
.dllA program-specific binary. Before Focus 3.1, a digitally steered column needed one with the same name beside its GLL.
.fc3, .fc2EASE Focus 3 and 2 project files. Focus 3 opens .fc2 and saves only .fc3.
.spk, .xhnThe old EASE SpeakerBase format and EASE’s ASCII balloon. SpeakerLab imports both.
.cf1, .cf2Common Loudspeaker Format, on 10° and 5° grids.

From the SpeakerLab guide (December 2016), the Focus 3 guide (February 2019) and the Focus upgrade history. AFMG don't publish the compiled format.

Resolution, and what it costs

The old SPK format kept a 5° balloon in third-octave bands from 100 Hz to 10 kHz (older EASE versions used 10° or 15°). A high-resolution GLL source keeps 1/24-octave points over the whole audio band. Counting magnitude and phase at every direction on the sphere, that's about 11 times the data per source at the same 5°, and a multi-way box has a set of those per driver.

FormatGridFrequencyDirectionsPoints eachValues per source
EASE SPKone point source per box5°1/3 octave, 100 Hz–10 kHz2,52221105,924
GLL, tabular sourcelegacy or imported data5°1/3 octave, 20 Hz–20 kHz2,52231156,364
GLL, high resolutionwhat AFMG recommend5°1/24 octave, 20 Hz–20 kHz2,5222401,210,560
GLL, high resolutionthe finest grid SpeakerLab offers1°1/24 octave, 20 Hz–20 kHz64,44224030,932,160

Full sphere, poles counted once, magnitude and phase. Bands are base-10 nominal third octaves. SpeakerLab ingests far more than it keeps: a 5° sphere is 2,664 impulse-response files, and at AES56's 8,192 points each that's 21.8 million samples per source before reduction. AFMG don't publish how a compiled GLL stores any of this, so take the counts as scale, not file size.

Two rules about phase, side by side

The SpeakerLab guide gives two criteria, both from the same idea: between neighbouring data points the phase mustn't turn by more than a quarter cycle. Both depend on r, the distance between the rotation point and the source's acoustic centre, because that offset is what makes phase spin as the box turns.

frequency: r ≤ c ÷ (4 · Δf)    angle: Δθ ≤ asin(c ÷ (4 · f · r))

  • Frequency. At 8 kHz neighbouring 1/24-octave points are 231 Hz apart, so r must stay under 0.37 m. That's the guide's own worked example, and the build checks it.
  • Angle. Put 5° into the second rule at 8 kHz and r must stay under 12 cm. The white paper elsewhere accepts a source 0.25 m from the rotation point at a 6 m distance, which answers a different question (the path to the microphone); at that offset the angular rule wants 2.5° steps, not 5.
  • What the two say together. A 5° GLL is good to 8 kHz when each driver was measured about a point close to its own acoustic centre, which is why the white paper asks for that for anything filtered separately. Above a few kHz, a GLL's phase is as good as the lab's choice of rotation point, and nothing in the file tells you which choice was made.
Grid step2 kHz4 kHz8 kHz16 kHz
1°148 cm74 cm37 cm19 cm
2°123 cm61 cm31 cm15 cm
5°49 cm25 cm12 cm6 cm
10°25 cm12 cm6 cm3 cm

The furthest the acoustic centre can sit from the rotation point and still meet both rules, with 1/24-octave data and c = 343 m/s. Greyed figures are where the frequency rule binds rather than the grid. The guide notes a third limit for line sources, whose nulls come closer together as the source gets taller, which is one more reason a line array box is measured as its drivers and not as one tall source.

Which programs read one

The same file doesn't work everywhere, which AFMG's own FAQ says up front. The differences are in what kind of object each program accepts and whether it insists on a paid-for authorisation.

ProgramAcceptsGLL + DLLAuthorisationNotes
EASE GLL ViewerLoudspeakers, clusters, line arraysNoOptionalFree. Views the data, runs calculations, saves .xglc configurations.
EASE 4 and EASE 5Loudspeakers, clusters, line arraysPartlyOptionalUnauthorised data loads and is marked as such.
EASE Focus 3Loudspeakers, line arraysPartlyLicensed per modelNo clusters. Free to you; the manufacturer pays.
EASE EvacLoudspeakers only—OptionalNeeds a rated coverage angle above zero.
EASE AddressLoudspeakers only—Licensed per modelNeeds a rated coverage angle above zero.

AFMG also list FIRmaker, their FIR filter optimiser, as a GLL reader. EASE Focus is a Windows program (.NET Framework 4.7.2 since 3.1.160); I run it in a Parallels VM on a Mac, which works. The GLL Viewer is a free download (1.1.61.260 at the time of writing) and wants .NET 3.5.

Why your box isn't in EASE Focus

Usually because nobody paid for it. EASE Focus 3 is free to you, and AFMG charge the loudspeaker company to add each model. Authorisations come in sets of five for one brand, the brand name is fixed at the first purchase, and the first set comes with a SpeakerLab Basic licence to build the files with.

Per model that works out at €1,060 for the first five and €860 after, so a manufacturer with a deep catalogue picks which boxes go in, and an installation-only box often doesn't make the cut. Variants (a rotated horn, a left and right pair) are sold as their own models, which is why a rotated version can turn up as a separate release months after the original.

The other reasons, roughly in the order I'd check them:

  • It's a cluster. Focus takes loudspeakers and line arrays, and a cluster-type GLL won't appear however you import it. EASE will run it.
  • It was authorised for Focus 2. Focus 3 only accepts single-model authorisations. The "unlimited" kind that was common under Focus 2 isn't supported any more, so an old GLL can need re-authorising before Focus 3 will take it.
  • Your copy of Focus came from a manufacturer. AFMG let a manufacturer ship an installer containing only its own data, and since 3.1.310 one that starts with the local database empty. Install AFMG's own copy, or import the GLL you need with Ctrl+I.
  • It's a steered column without its plug-in. Before 3.1 a steered column needed a Focus .dll with the same name in the same folder. Since 3.1 the plug-in can live inside the GLL.
LicencePer setPer model
First set of 5€5,300€1,060
Each further 5€4,300€860
5 variants€680€136

AFMG's EASE Focus 3 licence fees, version 5.0, February 2023, with a 10 % discount for several sets bought together. Prices change; this is the list I could find, not today's.

Which version you've got

Manufacturers version their own files, each in their own way. RCF's 2025 release names files like GTX10_25_v1_F3, with Focus 3 compatibility marked per model. Q-SYS number their library 4v01 and 4v02 with a separate revision per product family. Proel once released "EASE Focus GLL 3.0", which was for EASE Focus 2. A version number on a download is the manufacturer's, and it tells you nothing about which Focus it's for unless they say so.

  • Look in Focus. File → Manage System Definitions (Ctrl+Alt+M) lists what's installed, and its search covers manufacturer, system and GLL version. Hover the blue i for the definition's unique ID and any plug-ins it carries. Compare that with the manufacturer's download page before a show, not during it.
  • Import copies the file. Focus keeps its own copy of every GLL you import, so the download can go afterwards. It also means updating a box is a fresh import, and the old one stays in the database until you remove it.
  • Projects bring their own GLLs. Saving an .fc3 packs the GLL and DLL files it uses into the project, and opening someone else's project lists the system definitions you don't have and offers to save them into your database. Read what they are before pressing Save All: that's how an older GLL arrives on your machine attached to a project. I haven't tested which copy wins when two versions of one box are installed.
  • The GLL Viewer shows a file's information, authorisation and exposed settings without installing it into anything, and is the quickest way to look inside a GLL somebody emailed you. It doesn't open GLL + DLL packages.

What changes a prediction without a warning

  • Max SPL isn't comparable between brands. It's computed from whichever voltage the manufacturer entered as Program Vrms, and they don't agree on what that should mean. RCF's technical note tells you to take 12 dB off in AFMG software for a realistic continuous level. Q-SYS's 4v01 library changed its max SPL to continuous RMS (AES2 pink noise, 1 m, after a minute, with protection running). Focus then adds its own choice of input signal: Program (IEC 268), Music (EIA-426-B) or pink noise (AES2), each with a different spectrum. Read each manufacturer's note before putting two brands' max SPL side by side.
  • The preset you'll run may not be in the file. Line array presets come from the GLL; if it has none, Focus offers its own J-array, lined and curved shapes, which are geometry and not the manufacturer's processing. Filter settings appear only when the GLL exposes input filters. A ground-stacked sub left on its flown input configuration is 6 dB light in Q-SYS's case, and Q-SYS also warn that gain changed in EASE's object properties doesn't reach the individual boxes (the filter view does).
  • Limits are the manufacturer's model of the rigging. Weight and angle limits, minimum box counts and warnings are whatever the author wrote in, and Focus shows them in the status bar. Accessories outside the model aren't counted: Q-SYS note their pull-back hardware isn't in the simulation. A green status bar is the GLL agreeing with itself, and a rigging calculation is still somebody else's job.
  • Focus models direct sound only. No reflections, no shadowing, no wind; air absorption to ISO 9613 is included. Elements within one array are always summed coherently, which can overstate interference on tall arrays outdoors. Between separate arrays and loudspeakers it's coherent below a set frequency and power summation above, 250 Hz by default, crossfaded over an octave (177–354 Hz at the default; the guide's 1 kHz example runs 707 Hz to 1.41 kHz). Two hangs close together will interfere in the room more than the default shows them doing.
  • The venue gets tidied. Focus has no geometry import: you type coordinates or trace over a picture. Its audience zones are plan rectangles with a height profile, and AFMG document a 2 m minimum and a 45° maximum slope. The 2 m applies to width and is enforced silently: when I wrote 57 audience planes from a real theatre into a project for ArrayCAD, 45 of them came back from EASE Focus 3.1.260 widened to 2 m, centres unmoved, nothing on screen.

Before GLL, and beside it

  • SPK (1990). EASE's SpeakerBase: one point source per box, 5° balloon, 21 third-octave bands from 100 Hz to 10 kHz. Small, easy to produce, and unable to describe a multi-way box, a DSP preset or a mechanical configuration. SpeakerLab still imports it, and the ASCII .xhn.
  • DLL (EASE 4.0 on). A programmed Windows library per product, the most flexible option and tied to the one program it was written for. Before GLL a line array reached EASE as one of these, configured in the manufacturer's software or in EASE Focus. GLL object definitions grew out of them.
  • CLF. The Common Loudspeaker Format, an open alternative used by programs outside AFMG's: fixed tables, a 10° grid in .cf1 and 5° in .cf2, octave and third-octave bands, and phase only as third-octave averages per AFMG's comparison. AFMG's June 2014 count put GLL at 122 manufacturers and CLF at 26, which is a rival's census of a rival and worth weighing as such. A free CLF viewer is published by the CLF group.
  • Going down is allowed. SpeakerLab Pro exports a GLL's sources to the simpler formats (EASE .xhn, CADP2, Ulysses UNF and CLF 1 and 2). Nothing goes the other way: a GLL made from an SPK is a point source in a nicer file.
  • Manufacturer-only tools such as d&b ArrayCalc, L-Acoustics Soundvision and Meyer MAPP 3D run on their makers' own data and don't load GLLs. A manufacturer with its own tool may or may not publish GLLs as well, and when it does, check whether they're authorised for Focus or only for EASE. ArrayCAD moves venue geometry between ArrayCalc, Soundvision and an EASE Focus .fc3; the loudspeakers stay with each program.

Check a measurement grid

For anyone measuring boxes rather than predicting with them: pick a grid and a symmetry, say how far the source's acoustic centre sits from the rotation point and how high you need the data to hold, and it counts the files SpeakerLab will expect and checks both phase rules.

Try:

This calculator needs JavaScript. The table above covers the common grids.

File counts follow SpeakerLab's naming, with both poles on every meridian and both boundary meridians measured for the mirrored cases; SpeakerLab's own list of expected files is the authority. The rules are the guide's quarter-cycle criteria at c = 343 m/s. They say when the data can describe the phase, not whether the measurement was any good.

Sources

  • AFMG, GLL (Generic Loudspeaker Library): A New Standard for Measuring and Storing Loudspeaker Performance Data, engineering white paper, rev. October 2007. The object hierarchy, the two-step build, the measurement guidance (far field, rotation point, neighbours in place, 5° and about 1/24 octave), the DLL lineage and what the model leaves out.
  • AFMG, EASE SpeakerLab User's Guide, rev. 1.0, December 2016: §1.6 on SPK, DLL and GLL and the .xgll project, §1.7 on authorisation, §2.7.1–2.7.2 on resolution, file names and symmetry, §2.7.4.4 on maximum voltage, §2.9.2 on the .author file, Appendix B on .xglc, and §8.5.4–8.5.5 for the two phase criteria and the 230 Hz / 0.37 m example checked above.
  • AFMG, EASE Focus 3 User's Guide, rev. 3, February 2019: system definitions, import and management (§2.7–2.9), presets and limits, the calculation model and the summation crossfade (§4.3). It predates 3.1.310, so the .xglc and installer changes come from the EASE Focus upgrade history on afmg.eu, read to 3.1.321 (28 October 2026).
  • AFMG, FAQ entries "Can I use the same GLL loudspeaker file in all AFMG modeling programs?" and the customised-installer answer for manufacturers; the GLL Loudspeaker File Format page for the comparison with CLF and UNF and the June 2014 database counts; EASE Focus 3 License Fees, v5.0, 2 February 2023; the EASE GLL Viewer download listing.
  • Manufacturer notes: Q-SYS PL Series EASE Guide (library 4v01/4v02) for max SPL, input configurations, gain and accessories; RCF's technical note of 22 April 2025 on its version _25 GLLs and the 12 dB correction; Proel's "EASE Focus GLL 3.0" release for Focus 2 as reported by ProSoundWeb.
  • Not read directly: Feistel and Ahnert, "Modeling of Loudspeaker Systems Using High-Resolution Data", JAES 55 (7/8), 2007, and Feistel, Ahnert and Bock, "New Data Format to Describe Complex Sound Sources", AES 119th Convention paper 6631, 2005, both cited through the white paper; AES56-2008, cited through the SpeakerLab guide; the CLF grid sizes, from ODEON's documentation as summarised in search results.
  • My own: the .fc3 container and the silent 2 m widening, from reverse-engineering the project format against EASE Focus 3.1.260 for ArrayCAD on 3 August 2026.

Assembled 3 November 2026 with AI assistance. The figures AFMG publish that can be recomputed (the 1/24-octave spacing and 0.37 m limit, the summation crossfade, the SPK band count, the per-model fee) are checked at build time, and the 12 cm grid finding is computed from AFMG's own criterion. Those checks catch arithmetic, not a wrong source. I haven't taken a compiled GLL apart and AFMG don't document the format, so everything about its insides comes from AFMG's own description. The AFMG guides are 2016 and 2019 editions; current versions may word things differently.

Companion pages: inverse square law and air absorption for the ISO 9613 losses Focus adds, polarity, phase and time alignment for coherent against power summation and why phase data matters, and loudspeaker impedance for the rated impedance and 2.83 V sensitivity a GLL's figures are referred to.