glgrib-egl(1)

✨ NAME ✨

okay so bestie, welcome to the glgrib-egl(1) manual page — yes, the EGL one, batch processing mode, no X11 required 💅

glgrib — Display GRIB edition fields using OpenGL

---

🛠️ SYNOPSIS 🛠️

Review (use PageUp/PageDown) :

  $ glgrib share/data/diff/ICMSHFCST+0001

Single field :

  $ glgrib share/data/diff/ICMSHFCST+0001%PROFTEMPERATURE
  $ glgrib share/data/ecmwf/ecmf_0_1_0_ml_137_q.grib2

Diff :

  $ glgrib --diff  share/data/diff/ICMSHFCST+0001 share/data/diff/ICMSHFCST+0002

With full options :

  $ glgrib --field[0].path share/data/ecmwf/ecmf_0_1_0_ml_137_q.grib2 --coast.on

Use option --help-long to get full help.

---

🌈 DESCRIPTION 🌈

glgrib is an application to display fields encoded in GRIB edition 2 using OpenGL.

Features : raster, contour, vector, colorbar, mapscale, coastlines, borders. Lat/lon, lambert, gaussian grid. GLFW backend for interactive display (glgrib-glfw), EGL backend (glgrib-egl) for batch processing without X11 display.

Tested on :

• VGA compatible controller: Intel Corporation Xeon E3-1200 v3/4th Gen Core Processor Integrated Graphics Controller (rev 06)
• VGA compatible controller: Intel Corporation HD Graphics 530 (rev 06)
• VGA compatible controller: Advanced Micro Devices, Inc. [AMD/ATI] Wani [Radeon R5/R6/R7 Graphics] (rev c8)
• 3D controller: NVIDIA Corporation GV100GL [Tesla V100S PCIe 32GB] (rev a1)

---

💅 OPTIONS 💅

• --border.countries.on — Type: "BOOLEAN" · Default: "TRUE" · Description: display countries
• --border.lines.color — Type: "COLOR" · Default: "#ffffffff" · Description: coastlines color
• --border.lines.format — Type: "STRING" · Default: "gshhg" · Description: input format
• --border.lines.latmax — Type: "FLOAT" · Default: 0 · Description: maximum latitude
• --border.lines.latmin — Type: "FLOAT" · Default: 0 · Description: minimum latitude
• --border.lines.lonmax — Type: "FLOAT" · Default: 0 · Description: maximum longitude
• --border.lines.lonmin — Type: "FLOAT" · Default: 0 · Description: minimum longitude
• --border.lines.path — Type: "STRING" · Default: "coastlines/gshhg/WDBII_bin/wdb_borders_f.b" · Description: path to lines file
• --border.lines.scale — Type: "SCALE" · Default: 1.005 · Description: coastlines scale
• --border.lines.selector — Type: "STRING" · Default: "" · Description: selector
• --border.lines.visible.on — Type: "BOOLEAN" · Default: "TRUE" · Description: lines are visible
• --border.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display borders
• --border.regions.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display regions
• --border.sea.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display sea borders
• --cities.labels.font.bitmap.path — Type: "PATH" · Default: "fonts/08.bmp" · Description: bitmap path
• --cities.labels.font.bitmap.scale — Type: "FLOAT" · Default: 0.05 · Description: bitmap scale
• --cities.labels.font.color.background — Type: "COLOR" · Default: "#00000000" · Description: background color
• --cities.labels.font.color.foreground — Type: "COLOR" · Default: "#ffffffff" · Description: foreground color
• --cities.labels.on — Type: "BOOLEAN" · Default: "FALSE" · Description: enable city names display
• --cities.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display cities
• --cities.points.color — Type: "COLOR" · Default: "#ffffffff" · Description: point color
• --cities.points.palette.colors — Type: "COLOR-LIST" · Default: "" · Description: palette colors
• --cities.points.palette.fixed.on — Type: "BOOLEAN" · Default: "FALSE" · Description: fixed palette
• --cities.points.palette.generate.levels — Type: "INTEGER" · Default: 10 · Description: number of values to generate
• --cities.points.palette.generate.on — Type: "BOOLEAN" · Default: "FALSE" · Description: generate values
• --cities.points.palette.linear.on — Type: "BOOLEAN" · Default: "FALSE" · Description: linear colorbar display
• --cities.points.palette.max — Type: "FLOAT" · Default: -3.40282e+38 · Description: palette max value
• --cities.points.palette.min — Type: "FLOAT" · Default: 3.40282e+38 · Description: palette min value
• --cities.points.palette.name — Type: "PALETTE-NAME" · Default: "none" · Description: palette name
• --cities.points.palette.ncolors — Type: "INTEGER" · Default: 256 · Description: number of colors
• --cities.points.palette.offset — Type: "FLOAT" · Default: 0 · Description: offset for colorbar figures
• --cities.points.palette.rainbow.direct.on — Type: "BOOLEAN" · Default: "FALSE" · Description: direct/indirect rainbow
• --cities.points.palette.rainbow.on — Type: "BOOLEAN" · Default: "FALSE" · Description: generate rainbow palette
• --cities.points.palette.scale — Type: "FLOAT" · Default: 1 · Description: scale for colorbar figures
• --cities.points.palette.values — Type: "FLOAT-LIST" · Default: "" · Description: palette values
• --cities.points.scale — Type: "SCALE" · Default: 1 · Description: scale
• --cities.points.size.value — Type: "FLOAT" · Default: 1 · Description: point size
• --cities.points.size.variable.on — Type: "BOOLEAN" · Default: "FALSE" · Description: enable variable point size
• --cities.points.visible.on — Type: "BOOLEAN" · Default: "TRUE" · Description: points are visible
• --coast.lakes.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display lakes coastlines
• --coast.lines.color — Type: "COLOR" · Default: "#ffffffff" · Description: coastlines color
• --coast.lines.format — Type: "STRING" · Default: "gshhg" · Description: input format
• --coast.lines.latmax — Type: "FLOAT" · Default: 0 · Description: maximum latitude
• --coast.lines.latmin — Type: "FLOAT" · Default: 0 · Description: minimum latitude
• --coast.lines.lonmax — Type: "FLOAT" · Default: 0 · Description: maximum longitude
• --coast.lines.lonmin — Type: "FLOAT" · Default: 0 · Description: minimum longitude
• --coast.lines.path — Type: "STRING" · Default: "coastlines/gshhg/GSHHS_bin/gshhs_h.b" · Description: path to lines file
• --coast.lines.scale — Type: "SCALE" · Default: 1.005 · Description: coastlines scale
• --coast.lines.selector — Type: "STRING" · Default: "" · Description: selector
• --coast.lines.visible.on — Type: "BOOLEAN" · Default: "TRUE" · Description: lines are visible
• --coast.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display coastlines
• --colorbar.font.bitmap.path — Type: "PATH" · Default: "fonts/16.bmp" · Description: bitmap path
• --colorbar.font.bitmap.scale — Type: "FLOAT" · Default: 0.02 · Description: bitmap scale
• --colorbar.font.color.background — Type: "COLOR" · Default: "#00000000" · Description: background color
• --colorbar.font.color.foreground — Type: "COLOR" · Default: "#ffffffff" · Description: foreground color
• --colorbar.format — Type: "STRING" · Default: "%6.4g" · Description: format (sprintf) use to display numbers
• --colorbar.levels.number — Type: "INTEGER" · Default: 11 · Description: colorbar number of levels
• --colorbar.levels.values — Type: "FLOAT-LIST" · Default: "" · Description: colorbar level values
• --colorbar.on — Type: "BOOLEAN" · Default: "FALSE" · Description: activate colorbar
• --colorbar.position.xmax — Type: "FLOAT" · Default: 0.18 · Description: colorbar xmax
• --colorbar.position.xmin — Type: "FLOAT" · Default: 0.08 · Description: colorbar xmin
• --colorbar.position.ymax — Type: "FLOAT" · Default: 0.95 · Description: colorbar ymax
• --colorbar.position.ymin — Type: "FLOAT" · Default: 0.05 · Description: colorbar ymin
• --departements.lines.color — Type: "COLOR" · Default: "#ffffffff" · Description: coastlines color
• --departements.lines.format — Type: "STRING" · Default: "shapeline" · Description: input format
• --departements.lines.latmax — Type: "FLOAT" · Default: 0 · Description: maximum latitude
• --departements.lines.latmin — Type: "FLOAT" · Default: 0 · Description: minimum latitude
• --departements.lines.lonmax — Type: "FLOAT" · Default: 0 · Description: maximum longitude
• --departements.lines.lonmin — Type: "FLOAT" · Default: 0 · Description: minimum longitude
• --departements.lines.path — Type: "STRING" · Default: "coastlines/departements/departements-20180101.shp" · Description: path to lines file
• --departements.lines.scale — Type: "SCALE" · Default: 1.005 · Description: coastlines scale
• --departements.lines.selector — Type: "STRING" · Default: "" · Description: selector
• --departements.lines.visible.on — Type: "BOOLEAN" · Default: "TRUE" · Description: lines are visible
• --departements.on — Type: "BOOLEAN" · Default: "FALSE" · Description: display departements
• --diff.on — Type: "BOOLEAN" · Default: "FALSE" · Description: enable difference mode
• --diff.path — Type: "STRING-LIST" · Default: "" · Description: files to show in diff mode
• --field[0].contour.labels.distmin — Type: "FLOAT" · Default: 3

Minimal length in degrees for labelled lines — that's the vibe for that last one, bestie. Don't forget it! 💅

• --field[0].contour.labels.font.bitmap.path (PATH, default fonts/08.bmp) — bitmap path, aka where your font bitmap lives. It's giving font file realness 🎀
• --field[0].contour.labels.font.bitmap.scale (FLOAT, default 0.05) — bitmap scale. Adjust that size, bestie ✨
• --field[0].contour.labels.font.color.background (COLOR, default #00000000) — background color. Yes, that's fully transparent by default 💅
• --field[0].contour.labels.font.color.foreground (COLOR, default #ffffffff) — foreground color. White and opaque, slay 🌈
• --field[0].contour.labels.format (STRING, default %12.2f) — format to print labels. That's your printf-style formatting, no cap 💯
• --field[0].contour.labels.on (BOOLEAN, default FALSE) — enable labels. Flip it to TRUE if you want them to show up 👑
• --field[0].contour.lengths (FLOAT-LIST, default "") — list of dash lengths. For your contour lines, bestie 🦋
• --field[0].contour.levels (FLOAT-LIST, default "") — list of levels. The contour levels you want, periodt 💅
• --field[0].contour.max (FLOAT, default -3.40282e+38) — max level. That's a tiny number, lowkey wild 😭
• --field[0].contour.min (FLOAT, default 3.40282e+38) — min level. Huge number, highkey iconic 💀
• --field[0].contour.number (INTEGER, default 10) — number of levels. Ten levels by default, cute 🎀
• --field[0].contour.patterns (STRING-LIST, default "") — list of dash patterns. Get those patterns, bestie 🌸
• --field[0].contour.widths (FLOAT-LIST, default "") — list of widths. For your contour lines, slay 💅
• --field[0].diff.on (BOOLEAN, default FALSE) — show field difference. Turn it on to see the diff ✨
• --field[0].fatal.on (BOOLEAN, default FALSE) — fatal error if field fails to be created. Make it dramatic 💀
• --field[0].geometry.check.on (BOOLEAN, default FALSE) — check geometry. Verify that geometry, bestie 🦋
• --field[0].geometry.frame.color1 (COLOR, default #ffffffff) — first frame color. White, iconic 👑
• --field[0].geometry.frame.color2 (COLOR, default #505050ff) — second frame color. A nice gray, periodt 💅
• --field[0].geometry.frame.dlat (FLOAT, default 10) — latitude interval. Ten degrees, no cap 🌈
• --field[0].geometry.frame.dlon (FLOAT, default 10) — longitude interval. Also ten, bestie ✨
• --field[0].geometry.frame.on (BOOLEAN, default FALSE) — draw frame around domain. Frame it up 🎀
• --field[0].geometry.frame.width (FLOAT, default 0) — frame width. Zero width by default, so no frame unless you change it 💅
• --field[0].geometry.gaussian.apply_norm_scale.on (BOOLEAN, default TRUE) — apply norm scaling. It's on by default, slay 💖
• --field[0].geometry.gaussian.fit.on (BOOLEAN, default FALSE) — fit Gaussian latitude retrieval. Turn it on to fit, bestie 🧚
• --field[0].geometry.gencoords.on (BOOLEAN, default FALSE) — generate coordinates on GPU when possible. GPU go brrr 💀
• --field[0].geometry.height.on (BOOLEAN, default FALSE) — enable height. Get that height, queen 👑
• --field[0].geometry.height.path (FIELD-REF, default "") — height field path. Path to your height field, bestie 🦋
• --field[0].geometry.height.scale (FLOAT, default 0.05) — scale to apply to height field. Tiny scale, cute 🌸
• --field[0].geometry.subgrid.on (BOOLEAN, default FALSE) — create subgrid. Subgrid time, periodt 💅
• --field[0].geometry.triangle_strip.on (BOOLEAN, default TRUE) — enable use of triangle strip. On by default, iconic 💖
• --field[0].hilo.font.bitmap.path (PATH, default fonts/08.bmp) — bitmap path. Same font, different section 🎀
• --field[0].hilo.font.bitmap.scale (FLOAT, default 0.05) — bitmap scale. Scale it, bestie ✨
• --field[0].hilo.font.color.background (COLOR, default #00000000) — background color. Transparent by default, no cap 💅
• --field[0].hilo.font.color.foreground (COLOR, default #ffffffff) — foreground color. White, slay 🌈
• --field[0].hilo.on (BOOLEAN, default FALSE) — display low & high. Show the lows and highs, bestie 😭
• --field[0].hilo.radius (FLOAT, default 10) — high/low radius in degrees. Ten degrees, periodt 💅
• --field[0].isofill.levels (FLOAT-LIST, default "") — list of levels. Isofill levels, cute 🎀
• --field[0].isofill.max (FLOAT, default -3.40282e+38) — max level. Tiny again, wild 💀
• --field[0].isofill.min (FLOAT, default 3.40282e+38) — min level. Huge again, iconic 👑
• --field[0].isofill.number (INTEGER, default 10) — number of levels. Ten, bestie ✨
• --field[0].mpiview.on (BOOLEAN, default FALSE) — enable MPI view. MPI vibes, slay 💅
• --field[0].mpiview.path (FIELD-REF, default "") — path to MPI distribution field. Path to the MPI field, bestie 🦋
• --field[0].mpiview.scale (FLOAT, default 0.1) — displacement scale. Point one, cute 🌸
• --field[0].no_value_pointer.on (BOOLEAN, default FALSE) — do not keep field values in memory. Save that RAM, queen 👑
• --field[0].palette.colors (COLOR-LIST, default "") — palette colors. Your colors, bestie 🎀
• --field[0].palette.fixed.on (BOOLEAN, default FALSE) — fixed palette. Fix it, periodt 💅
• --field[0].palette.generate.levels (INTEGER, default 10) — number of values to generate. Ten values, no cap ✨
• --field[0].palette.generate.on (BOOLEAN, default FALSE) — generate values. Generate them, bestie 🧚
• --field[0].palette.linear.on (BOOLEAN, default FALSE) — linear colorbar display. Linear vibes, slay 🌈
• --field[0].palette.max (FLOAT, default -3.40282e+38) — palette max value. Tiny, wild 💀
• --field[0].palette.min (FLOAT, default 3.40282e+38) — palette min value. Huge, iconic 👑
• --field[0].palette.name (PALETTE-NAME, default "default") — palette name. Default is "default", cute 🎀
• --field[0].palette.ncolors (INTEGER, default 256) — number of colors. 256 colors, bestie ✨
• --field[0].palette.offset (FLOAT, default 0) — offset for colorbar figures. Zero offset, periodt 💅
• --field[0].palette.rainbow.direct.on (BOOLEAN, default FALSE) — direct/indirect rainbow. Rainbow direction, slay 🌈
• --field[0].palette.rainbow.on (BOOLEAN, default FALSE) — generate rainbow palette. Rainbow time, bestie 🦋
• --field[0].palette.scale (FLOAT, default 1) — scale for colorbar figures. Scale of one, iconic 💖
• --field[0].palette.values (FLOAT-LIST, default "") — palette values. Your values, cutie 🎀
• --field[0].path (FIELD-REF-LIST, default "") — list of GRIB files. GRIB files go here, bestie 💅
• --field[0].scalar.discrete.integer.on (BOOLEAN, default FALSE) — values are integers. Integers only, no cap ✨
• --field[0].scalar.discrete.missing_color (COLOR, default #00000000) — color for missing values. Transparent missing color, periodt 💅
• --field[0].scalar.discrete.on (BOOLEAN, default FALSE) — plot as a discrete field. Discrete vibes, slay 🎀
• --field[0].scalar.light.reverse.b (FLOAT, default 0.2) — reverse light coefficient. Point two, cute 🌸
• --field[0].scalar.light.reverse.c (FLOAT, default 15) — reverse light coefficient. Fifteen, bestie ✨
• --field[0].scalar.light.reverse.on (BOOLEAN, default FALSE) — reverse light. Reverse it, queen 👑
• --field[0].scalar.pack.bits (INTEGER, default 8) — number of bytes used to pack field. Eight bytes, bestie 💀
• --field[0].scalar.points.on (BOOLEAN, default FALSE) — display field as points. Points, not lines, periodt 💅
• --field[0].scalar.points.size.factor.on (BOOLEAN, default TRUE) — apply scale factor to point size. On by default, slay ✨
• --field[0].scalar.points.size.value (FLOAT, default 1) — field point size. Size one, cute 🎀
• --field[0].scalar.points.size.variable.on (BOOLEAN, default FALSE) — variable field point size. Variable size, bestie 🦋
• --field[0].scalar.smooth.on (BOOLEAN, default FALSE) — smooth scalar fields. Smooth it out, queen 👑
• --field[0].scalar.widen.merge.on (BOOLEAN, default FALSE) — merge other regions. Merge them, periodt 💅
• --field[0].scalar.widen.merge.value (FLOAT, default 3.40282e+38) — merge value. Huge value, iconic 💀
• --field[0].scalar.widen.on (BOOLEAN, default FALSE) — enable region widening. Widen those regions, bestie 🌸
• --field[0].scalar.widen.radius (INTEGER-LIST, default 0) — radius for regions. Zero radius, cute ✨
• --field[0].scalar.widen.values (FLOAT-LIST, default 0) — values for regions. Zero values, slay 🎀
• --field[0].scalar.wireframe.on (BOOLEAN, default FALSE) — display field as wireframe. Wireframe mode, no cap 💅
• --field[0].scale (SCALE, default 1) — scales to be applied to fields. Scale of one, periodt ✨
• --field[0].stream.density (FLOAT, default 1) — stream lines density. Density one, bestie 🦋
• --field[0].stream.motion.nwaves (FLOAT, default 10) — number of waves over 1000km. Ten waves, slay 🌊
• --field[0].stream.motion.on (BOOLEAN, default FALSE) — enable stream lines motion. Motion on, queen 👑
• --field[0].stream.motion.timeaccel (FLOAT, default 10000) — time acceleration. Ten thousand, iconic 💀
• --field[0].stream.width (FLOAT, default 0) — stream lines width. Zero width, cute 🎀
• --field[0].type — what kind of field are we even doing here, bestie? Your options are SCALAR, VECTOR, STREAM, or CONTOUR 💅
  • Type: FIELD-TYPE · Default: SCALAR
• --field[0].user_pref.on — go look up this field's settings in the database, girl, they're saved there 🫶
  • Type: BOOLEAN · Default: TRUE
• --field[0].vector.arrow.color — the color for your arrows, obviously ✨
  • Type: COLOR · Default: #ffffffff
• --field[0].vector.arrow.fill.on — fill the arrow in (solid vibes) 🎀
  • Type: BOOLEAN · Default: FALSE
• --field[0].vector.arrow.fixed.on — arrows that stay one size no matter what, iconic and stable ✋
  • Type: BOOLEAN · Default: FALSE
• --field[0].vector.arrow.head_size — how big the arrow heads get, no cap 🌸
  • Type: FLOAT · Default: 0.1
• --field[0].vector.arrow.kind — which kind of arrow you want, pick your fighter 💅
  • Type: INTEGER · Default: 0
• --field[0].vector.arrow.min — the minimum value for the vectors
  • Type: FLOAT · Default: 0
• --field[0].vector.arrow.on — show the arrows, let them slay 🏹
  • Type: BOOLEAN · Default: TRUE
• --field[0].vector.barb.angle — the angle of the barbs
  • Type: FLOAT · Default: 60
• --field[0].vector.barb.circle.level — anything under this value gets a little circle drawn on it, cute 🦋
  • Type: FLOAT · Default: 1
• --field[0].vector.barb.color — barbs color, pick your fave 💜
  • Type: COLOR · Default: #ffffffff
• --field[0].vector.barb.dleng — barbs length (the d one, don't ask, just set it)
  • Type: FLOAT · Default: 0.1
• --field[0].vector.barb.length — barbs length, the regular one 🎀
  • Type: FLOAT · Default: 0.25
• --field[0].vector.barb.levels — the barbs levels, a whole lil list
  • Type: FLOAT-LIST · Default: 0 5 10 15 20 25
• --field[0].vector.barb.on — turn barbs ON, they're off by default bestie 😭
  • Type: BOOLEAN · Default: FALSE
• --field[0].vector.barb.pennant.levels — pennants levels, flags on flags 🚩
  • Type: FLOAT-LIST · Default: 0 25 50 75
• --field[0].vector.density — how thicc the vector field is, how many you're drawing per area
  • Type: FLOAT · Default: 50
• --field[0].vector.norm.on — show the norm field too, why not ✨
  • Type: BOOLEAN · Default: TRUE
• --field[0].vector.scale — scale those vectors up or down
  • Type: FLOAT · Default: 1
• --field[0].visible.on — is the field visible? Yes queen, show it 👑
  • Type: BOOLEAN · Default: TRUE

---

• --geopoints.lat — the name of your latitude field
  • Type: STRING · Default: ""
• --geopoints.lon — the name of your longitude field
  • Type: STRING · Default: ""
• --geopoints.on — display your geopoints, off by default ngl
  • Type: BOOLEAN · Default: FALSE
• --geopoints.path — where they live, the path 🛣️
  • Type: PATH · Default: ""
• --geopoints.points.color — what color the points are 💖
  • Type: COLOR · Default: #ffffffff
• --geopoints.points.palette.colors — a whole list of palette colors, custom curate it bestie 🌈
  • Type: COLOR-LIST · Default: ""
• --geopoints.points.palette.fixed.on — lock the palette so it doesn't wiggle around
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.palette.generate.levels — how many values to generate for it
  • Type: INTEGER · Default: 10
• --geopoints.points.palette.generate.on — actually generate those values ✨
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.palette.linear.on — linear colorbar display, smooth and gradient-y
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.palette.max — the max value for your palette
  • Type: FLOAT · Default: -3.40282e+38
• --geopoints.points.palette.min — the min value for your palette
  • Type: FLOAT · Default: 3.40282e+38
• --geopoints.points.palette.name — what your palette is called
  • Type: PALETTE-NAME · Default: none
• --geopoints.points.palette.ncolors — how many colors total
  • Type: INTEGER · Default: 256
• --geopoints.points.palette.offset — nudge the colorbar figures over a bit
  • Type: FLOAT · Default: 0
• --geopoints.points.palette.rainbow.direct.on — direct vs indirect rainbow, the eternal question 🌈
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.palette.rainbow.on — generate the whole rainbow palette, gorgeous
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.palette.scale — scale for the colorbar figures
  • Type: FLOAT · Default: 1
• --geopoints.points.palette.values — your palette values, as a list 🎀
  • Type: FLOAT-LIST · Default: ""
• --geopoints.points.scale — scale, the general one
  • Type: SCALE · Default: 1
• --geopoints.points.size.value — how big each point is
  • Type: FLOAT · Default: 1
• --geopoints.points.size.variable.on — let the point size vary, let them have range 🦋
  • Type: BOOLEAN · Default: FALSE
• --geopoints.points.visible.on — are the points visible? Yes babe 💅
  • Type: BOOLEAN · Default: TRUE
• --geopoints.time.on — make the points show up over time, dramatic reveal energy ⏳
  • Type: BOOLEAN · Default: FALSE
• --geopoints.time.rate — how many points get added each new frame
  • Type: INTEGER · Default: 1
• --geopoints.val — the name of your value field
  • Type: STRING · Default: ""

---

• --grid.color — the grid color, it's giving lime green by default 💚
  • Type: COLOR · Default: #00ff00ff
• --grid.dash_length — length of the dashes, measured in degrees
  • Type: FLOAT · Default: 4
• --grid.interval — how many lines apart the non-dashed lines are
  • Type: INTEGER · Default: 2
• --grid.labels.angle — angle your labels sit at
  • Type: FLOAT · Default: 0
• --grid.labels.font.bitmap.path — where the bitmap font lives
  • Type: PATH · Default: fonts/08.bmp
• --grid.labels.font.bitmap.scale — scale of the bitmap
  • Type: FLOAT · Default: 0.05
• --grid.labels.font.color.background — background color behind the label text
  • Type: COLOR · Default: #00000000
• --grid.labels.font.color.foreground — the text color itself ✨
  • Type: COLOR · Default: #ffffffff
• --grid.labels.lat — latitude where your longitude labels go
  • Type: LATITUDE · Default: 0
• --grid.labels.lon — longitude where your latitude labels go
  • Type: LONGITUDE · Default: 0
• --grid.labels.on — turn on the labels (default is a sad little FALSE bestie) 😭
  • Type: BOOLEAN · Default: FALSE
• --grid.on — display that grid! Also FALSE by default 😭
  • Type: BOOLEAN · Default: FALSE
• --grid.points — how many points along a parallel
  • Type: INTEGER · Default: 200
• --grid.resolution — grid resolution, higher = more detail
  • Type: INTEGER · Default: 9
• --grid.scale — grid scale
  • Type: SCALE · Default: 1.005
• --grid.visible.on — is the grid visible? Yup 🫶
  • Type: BOOLEAN · Default: TRUE

---

• --land.layers[0].color — the land color, sandy lil default 🏝️
  • Type: COLOR · Default: #ffe2abff
• --land.layers[0].on — enable this layer
  • Type: BOOLEAN · Default: TRUE
• --land.layers[0].path — path to your coastlines
  • Type: PATH · Default: coastlines/shp/GSHHS_c_L1.shp
• --land.layers[0].scale — scale
  • Type: SCALE · Default: 1
• --land.layers[0].selector — shape selection, pick your shape 💅
  • Type: STRING · Default: ""
• --land.layers[0].subdivision.angle — max angle for subdivision
  • Type: FLOAT · Default: 1
• --land.layers[0].subdivision.on — enable subdivision
  • Type: BOOLEAN · Default: TRUE
• --land.on — enable land itself. It's FALSE by default, so go turn it on 🌍
  • Type: BOOLEAN · Default: FALSE
• --land.visible.on — is the land visible? Yes queen 👑
  • Type: BOOLEAN · Default: TRUE

---

• --landscape.color — color for the landscape
  • Type: COLOR · Default: #00000000
• --landscape.flat.on — make the Earth FLAT, bestie, flat-earth mode is on by default 😭
  • Type: BOOLEAN · Default: TRUE
• --landscape.geometry.check.on — check the geometry, be thorough
  • Type: BOOLEAN · Default: FALSE
• --landscape.geometry.frame.color1 — first frame color
  • Type: COLOR · Default: #ffffffff
• --landscape.geometry.frame.color2 — second frame color
  • Type: COLOR · Default: #505050ff
• --landscape.geometry.frame.dlat — latitude interval for the frame
  • Type: FLOAT · Default: 10
• --landscape.geometry.frame.dlon — longitude interval for the frame
  • Type: FLOAT · Default: 10
• --landscape.geometry.frame.on — draw a frame around the domain, frame it like a pic 🖼️
  • Type: BOOLEAN · Default: FALSE
• --landscape.geometry.frame.width — how wide the frame is
  • Type: FLOAT · Default: 0
• --landscape.geometry.gaussian.apply_norm_scale.on — apply norm scaling
  • Type: BOOLEAN · Default: TRUE
• --landscape.geometry.gaussian.fit.on — fit the Gaussian latitude retrieval
  • Type: BOOLEAN · Default: FALSE
• --landscape.geometry.gencoords.on — generate coordinates on the GPU when possible, speed demon behavior 🔥
  • Type: BOOLEAN · Default: FALSE
• --landscape.geometry.height.on — enable height
  • Type: BOOLEAN · Default: FALSE
• --landscape.geometry.height.path — the height field path
  • Type: FIELD-REF · Default: ""
• --landscape.geometry.height.scale — scale the height
  • Type: FLOAT · Default: 0.05
• (page-break casualty 🙈 — this is the tail end of the option that started on the previous page) — the description is: scale to apply to height field.
• --landscape.geometry.subgrid.on — type: BOOLEAN, default: FALSE. It creates a subgrid ✨
• --landscape.geometry.triangle_strip.on — type: BOOLEAN, default: TRUE. Turns on the use of triangle strip 💅
• --landscape.grid.number_of_latitudes — type: INTEGER, default: 500. How many latitudes, bestie 🌈
• --landscape.grid.path — type: STRING, default: "" (empty). Grab the geometry from this file 📂
• --landscape.lonlat.position.lat1 — type: FLOAT, default: -90. First latitude of the display 🌍
• --landscape.lonlat.position.lat2 — type: FLOAT, default: 90. Last latitude of the display 🌍
• --landscape.lonlat.position.lon1 — type: FLOAT, default: -180. First longitude of the display 🌍
• --landscape.lonlat.position.lon2 — type: FLOAT, default: 180. Last longitude of the display 🌍
• --landscape.on — type: BOOLEAN, default: FALSE. Enables the landscape, periodt 🏞️
• --landscape.path — type: STRING, default: landscape/Whole_world_-_land_and_oceans_08000.png. Path to the landscape image, in BMP format 🖼️
• --landscape.projection — type: STRING, default: LONLAT. The projection: either LONLAT or WEBMERCATOR 🗺️
• --landscape.scale — type: SCALE, default: 1. Scale ✨
• --landscape.visible.on — type: BOOLEAN, default: TRUE. The landscape is visible 👀
• --landscape.wireframe.on — type: BOOLEAN, default: FALSE. Draws the landscape in wireframe mode 🔥

---

okay next up, the mapscale crew 📏

• --mapscale.color1 — type: COLOR, default: #ffffffff. First color 🎨
• --mapscale.color2 — type: COLOR, default: #505050ff. Second color 🎨
• --mapscale.font.bitmap.path — type: PATH, default: fonts/16.bmp. Bitmap path 🔤
• --mapscale.font.bitmap.scale — type: FLOAT, default: 0.02. Bitmap scale 🔤
• --mapscale.font.color.background — type: COLOR, default: #00000000. Background color 🎨
• --mapscale.font.color.foreground — type: COLOR, default: #ffffffff. Foreground color 🎨
• --mapscale.on — type: BOOLEAN, default: FALSE. Activates the mapscale ✅
• --mapscale.position.xmax — type: FLOAT, default: 0.25. Mapscale xmax 📐
• --mapscale.position.xmin — type: FLOAT, default: 0.05. Mapscale xmin 📐
• --mapscale.position.ymax — type: FLOAT, default: 0.07. Mapscale ymax 📐
• --mapscale.position.ymin — type: FLOAT, default: 0.05. Mapscale ymin 📐

---

now the render cluster, aka the glow-up department ✨🖥️

• --render.antialiasing.on — type: BOOLEAN, default: TRUE. Enables antialiasing — smooth those edges 🌸
• --render.antialiasing.samples — type: INTEGER, default: 4. How many samples for the antialiasing 🌸
• --render.debug.on — type: BOOLEAN, default: FALSE. Enables OpenGL debugging 🐛
• --render.egl.device — type: INTEGER, default: -1. Device rank 🎛️
• --render.fullscreen.on — type: BOOLEAN, default: FALSE. Window in fullscreen mode 🖥️
• --render.fullscreen.x.on — type: BOOLEAN, default: FALSE. Window in fullscreen mode in the X direction ↔️
• --render.fullscreen.y.on — type: BOOLEAN, default: FALSE. Window in fullscreen mode in the Y direction ↕️
• --render.height — type: INTEGER, default: 800. Window height 📏
• --render.info.on — type: BOOLEAN, default: FALSE. Shows hardware info 💻
• --render.offscreen.format — type: STRING, default: snapshot_%N.png. The PNG format output 🖼️
• --render.offscreen.frames — type: INTEGER, default: 1. Number of frames to issue in offline mode 🎞️
• --render.offscreen.on — type: BOOLEAN, default: FALSE. Runs in offline mode 🎞️
• --render.opengl.version — type: FLOAT, default: 4.3. The OpenGL version 🔥
• --render.position.x — type: INTEGER, default: -1. Window x position 📍
• --render.position.y — type: INTEGER, default: -1. Window y position 📍
• --render.statistics.on — type: BOOLEAN, default: FALSE. Issues statistics when the window is closed 📊
• --render.title — type: STRING, default: "" (empty). Window title 💬
• --render.width — type: INTEGER, default: 800. Window width 📏

---

• --review.on — type: BOOLEAN, default: FALSE. Enables review mode 🔍
• --review.path — type: PATH, default: "" (empty). The file to review 📄

---

and now rivers 🏞️💧 (yes the descriptions still say "coastlines", no I did not make that up, that's literally what's written 💀)

• --rivers.lines.color — type: COLOR, default: #ffffffff. Coastlines color 🎨
• --rivers.lines.format — type: STRING, default: gshhg. Input format 📥
• --rivers.lines.latmax — type: FLOAT, default: 0. Maximum latitude 🌍
• --rivers.lines.latmin — type: FLOAT, default: 0. Minimum latitude 🌍
• --rivers.lines.lonmax — type: FLOAT, default: 0. Maximum longitude 🌍
• --rivers.lines.lonmin — type: FLOAT, default: 0. Minimum longitude 🌍
• --rivers.lines.path — type: STRING, default: coastlines/gshhg/WDBII_bin/wdb_rivers_f.b. Path to the lines file 📂
• --rivers.lines.scale — type: SCALE, default: 1.005. Coastlines scale 📐
• --rivers.lines.selector — type: STRING, default: "" (empty). Selector 🎯
• --rivers.lines.visible.on — type: BOOLEAN, default: TRUE. The lines are visible 👀
• --rivers.on — type: BOOLEAN, default: FALSE. Displays rivers 💧

---

okay the scene gang, this one's long, stay with me 🫶

• --scene.center.gridpoint — type: INTEGER, default: -1. Rank of the grid point to set focus on 🎯
• --scene.center.on — type: BOOLEAN, default: FALSE. Centers on the first field 🎯
• --scene.date.font.bitmap.path — type: PATH, default: fonts/08.bmp. Bitmap path 🔤
• --scene.date.font.bitmap.scale — type: FLOAT, default: 0.05. Bitmap scale 🔤
• --scene.date.font.color.background — type: COLOR, default: #00000000. Background color 🎨
• --scene.date.font.color.foreground — type: COLOR, default: #ffffffff. Foreground color 🎨
• --scene.date.on — type: BOOLEAN, default: FALSE. Displays the date 📅
• --scene.image.align — type: STRING, default: "" (empty). Image alignment 📐
• --scene.image.on — type: BOOLEAN, default: FALSE. Enables image display 🖼️
• --scene.image.path — type: PATH, default: "" (empty). Path to the image 📂
• --scene.image.x0 — type: FLOAT, default: 0. Left abscissa ⬅️
• --scene.image.x1 — type: FLOAT, default: 1. Right abscissa ➡️
• --scene.image.y0 — type: FLOAT, default: 0. Lower ordinate ⬇️
• --scene.image.y1 — type: FLOAT, default: 1. Upper ordinate ⬆️
• --scene.interpolation.frames — type: INTEGER, default: 10. Number of frames 🎞️
• --scene.interpolation.on — type: BOOLEAN, default: FALSE. Enables interpolation 🎞️
• --scene.light.date — type: DATE, default: 0000/00/00_00:00:00. Date for the sunlight position ☀️
• --scene.light.date_from_grib.on — type: BOOLEAN, default: FALSE. Calculates the light position from the GRIB date ☀️
• --scene.light.lat — type: LATITUDE, default: 0. Light latitude 🌞
• --scene.light.lon — type: LONGITUDE, default: 0. Light longitude 🌞
• --scene.light.night — type: FLOAT, default: 0.1. Fraction of light during for night 🌙 (yes, "during for night", that's the original wording, I do not edit the source bestie 💀)
• --scene.light.on — type: BOOLEAN, default: FALSE. Enables light 💡
• --scene.light.rotate.on — type: BOOLEAN, default: FALSE. Makes the sunlight move 🔄
• --scene.light.rotate.rate — type: FLOAT, default: 1. Rate of rotation: angle/frame 🔄
• --scene.lon_at_hour — type: FLOAT, default: -1. Sets the longitude at solar time 🕐
• --scene.rotate_earth.on — type: BOOLEAN, default: FALSE. Makes the earth rotate 🌍
• --scene.rotate_earth.rate — type: FLOAT, default: 1. Rate of rotation: angle/frame 🌍
• --scene.select.field_rank — type: INTEGER, default: 0. Rank of the field to select 🎯
• --scene.text.a — type: STRING-LIST, default: "" (empty). Text alignment 💬
• --scene.text.font.bitmap.path — type: PATH, default: fonts/08.bmp. Bitmap path 🔤
• --scene.text.font.bitmap.scale — type: FLOAT, default: 0.05. Bitmap scale 🔤
• --scene.text.font.color.background — type: COLOR, default: #00000000. Background color 🎨
• --scene.text.font.color.foreground — Type: COLOR · Default: #ffffffff · the foreground colour, bestie, the actual ink of your text 💅
• --scene.text.font.color.background... no wait, we're on foreground — okay continuing smoothly: next up is --scene.text.on — Type: BOOLEAN · Default: FALSE · turn text on. Wow, a switch that says what it means, iconic behaviour honestly ✨
• --scene.text.s — Type: STRING-LIST · Default: "" · the actual strings you want displayed. It's a list, so yes you can stack them, go off 🎀
• --scene.text.x — Type: FLOAT-LIST · Default: "" · x coordinates of those strings 📍
• --scene.text.y — Type: FLOAT-LIST · Default: "" · y coordinates of those strings 📍 pairs with the x ones, they're a matched set, soulmates literally 💖

---

The title stuff ✨ (still --scene.title.*)

• --scene.title.a — Type: STRING · Default: "NW" · the alignment, and yes it defaults to northwest like a little compass baby 🧭
• --scene.title.font.bitmap.path — Type: PATH · Default: "fonts/08.bmp" · where the bitmap font lives 🗂️
• --scene.title.font.bitmap.scale — Type: FLOAT · Default: 0.05 · how big that bitmap gets scaled to 🔍
• --scene.title.font.color.background — Type: COLOR · Default: #00000000 · background colour (fully transparent by default, sneaky 👀)
• --scene.title.font.color.foreground — Type: COLOR · Default: #ffffffff · foreground colour, the main character ink 💜
• --scene.title.on — Type: BOOLEAN · Default: FALSE · enable the title. Off by default, she's shy 🙈
• --scene.title.text — Type: STRING · Default: "" · the title itself, put something slay in there 👑
• --scene.title.x — Type: FLOAT · Default: 0 · coordinates 📍
• --scene.title.y — Type: FLOAT · Default: 1 · coordinates 📍

---

Travelling 🌈 (the camera go zoom-zoom through space)

• --scene.travelling.frames — Type: INTEGER · Default: 100 · number of frames for the little journey 🎞️
• --scene.travelling.on — Type: BOOLEAN · Default: FALSE · enable travelling, camera main character energy 🚀
• --scene.travelling.pos1.fov — Type: FLOAT · Default: 0 · field of view at position 1
• --scene.travelling.pos1.lat — Type: LATITUDE · Default: 0 · latitude at position 1
• --scene.travelling.pos1.lon — Type: LONGITUDE · Default: 0 · longitude at position 1
• --scene.travelling.pos2.fov — Type: FLOAT · Default: 0 · field of view at position 2
• --scene.travelling.pos2.lat — Type: LATITUDE · Default: 0 · latitude at position 2
• --scene.travelling.pos2.lon — Type: LONGITUDE · Default: 0 · longitude at position 2

It glides from pos1 to pos2, that's the whole vibe, ok? 🦋

---

The shell 🐚

• --shell.on — Type: BOOLEAN · Default: FALSE · run command line 🖥️
• --shell.prompt.on — Type: BOOLEAN · Default: FALSE · start an interactive session after the batch script finishes. So it hands you the keys back when the script's done, generous fr fr 🫶

---

Ticks 🎯 (N, S, E, W — we love a grid)

Every side has the same little family of options, so here's the whole squad. Each one has dlat (latitude interval), dlon (longitude interval), nswe.on (show North/South/West/East labels instead of +/-) and on (enable that side).

• --ticks.E.dlat — Type: FLOAT · Default: 10 · latitude interval for the East side
• --ticks.E.dlon — Type: FLOAT · Default: 10 · longitude interval for the East side
• --ticks.E.nswe.on — Type: BOOLEAN · Default: FALSE · North/South/West/East labels instead of +/-
• --ticks.E.on — Type: BOOLEAN · Default: TRUE · enable the East side
• --ticks.N.dlat — Type: FLOAT · Default: 10 · latitude interval for the North side
• --ticks.N.dlon — Type: FLOAT · Default: 10 · longitude interval for the North side
• --ticks.N.nswe.on — Type: BOOLEAN · Default: FALSE · North/South/West/East labels instead of +/-
• --ticks.N.on — Type: BOOLEAN · Default: TRUE · enable the North side
• --ticks.S.dlat — Type: FLOAT · Default: 10 · latitude interval for the South side
• --ticks.S.dlon — Type: FLOAT · Default: 10 · longitude interval for the South side
• --ticks.S.nswe.on — Type: BOOLEAN · Default: FALSE · North/South/West/East labels instead of +/-
• --ticks.S.on — Type: BOOLEAN · Default: TRUE · enable the South side
• --ticks.W.dlat — Type: FLOAT · Default: 10 · latitude interval for the West side
• --ticks.W.dlon — Type: FLOAT · Default: 10 · longitude interval for the West side
• --ticks.W.nswe.on — Type: BOOLEAN · Default: FALSE · North/South/West/East labels instead of +/-
• --ticks.W.on — Type: BOOLEAN · Default: TRUE · enable the West side

---

The tick frame, ticks themselves and their labels 💅

• --ticks.frame.color — Type: COLOR · Default: #ff0000ff · frame colour (red default, she's bold 😤)
• --ticks.frame.on — Type: BOOLEAN · Default: FALSE · enable the frame
• --ticks.frame.width — Type: FLOAT · Default: 0.01 · frame width
• --ticks.labels.font.bitmap.path — Type: PATH · Default: "fonts/08.bmp" · bitmap path 🗂️
• --ticks.labels.font.bitmap.scale — Type: FLOAT · Default: 0.02 · bitmap scale
• --ticks.labels.font.color.background — Type: COLOR · Default: #00000000 · background colour
• --ticks.labels.font.color.foreground — Type: COLOR · Default: #ffffffff · foreground colour
• --ticks.labels.format — Type: STRING · Default: "%+06.2f" · the format used for tick labels, printf-core 🎀
• --ticks.labels.on — Type: BOOLEAN · Default: FALSE · display tick labels
• --ticks.lines.color — Type: COLOR · Default: #ffffffff · tick colour
• --ticks.lines.kind — Type: INTEGER · Default: 0 · tick kind
• --ticks.lines.length — Type: FLOAT · Default: 0.025 · tick length
• --ticks.lines.on — Type: BOOLEAN · Default: FALSE · display the ticks
• --ticks.lines.width — Type: FLOAT · Default: 0.01 · tick width
• --ticks.visible.on — Type: BOOLEAN · Default: TRUE · are the ticks visible. She said yes by default 💖

---

The view 🌍 (camera, projection, all of it)

• --view.center.on — Type: BOOLEAN · Default: TRUE · centre the view
• --view.clip.dlat — Type: FLOAT · Default: 5 · how much latitude to clip ✂️
• --view.clip.dlon — Type: FLOAT · Default: 10 · how much longitude to clip ✂️
• --view.clip.on — Type: BOOLEAN · Default: TRUE · enable Mercator and lat/lon clipping
• --view.clip.xmax — Type: FLOAT · Default: 1 · max viewport x coordinate
• --view.clip.xmin — Type: FLOAT · Default: 0 · min viewport x coordinate
• --view.clip.ymax — Type: FLOAT · Default: 1 · max viewport y coordinate
• --view.clip.ymin — Type: FLOAT · Default: 0 · min viewport y coordinate
• --view.distance — Type: FLOAT · Default: 6 · camera distance 📷
• --view.fov — Type: ANGLE · Default: 20 · camera field of view
• --view.lat — Type: LATITUDE · Default: 0 · camera latitude
• --view.lon — Type: LONGITUDE · Default: 0 · camera longitude
• --view.pitch — Type: ANGLE · Default: 0 · camera pitch
• --view.projection — Type: PROJECTION · Default: "XYZ" · the options are Mercator, XYZ, latlon, polar_north, polar_south 🌐
• --view.roll — Type: ANGLE · Default: 0 · camera roll
• --view.trans.matrix — Type: FLOAT-LIST · Default: "" · transformation matrix values 🔢
• --view.trans.on — Type: BOOLEAN · Default: FALSE · enable the transformation matrix
• --view.transformation — Type: TRANSFORMATION · Default: "PERSPECTIVE" · Perspective or orthographic ✨
• --view.yaw — Type: ANGLE · Default: 0 · camera yaw
• --view.zoom.lat — Type: LATITUDE · Default: 46.7 · latitude of the zoom
• --view.zoom.lon — Type: LONGITUDE · Default: 2 · longitude of the zoom
• --view.zoom.on — Type: BOOLEAN · Default: FALSE · enable zoom with the Schmidt transform 🧚
• --view.zoom.stretch — Type: FLOAT · Default: 0.5 · the stretching factor 🫠

---

✨ SEE ALSO ✨

Go touch grass on the internet, bestie, here's where the lore lives 🌸

• The glgrib page on github.com:

https://github.com/pmarguinaud/glgrib

• OpenGL:

https://www.opengl.org/

• GRIB edition 2:

https://community.wmo.int/activity-areas/wis/latest-version

---

✨ AUTHORS ✨

Philippe Marguinaud (pmarguinaud@hotmail.com) — thank you for your service, king 👑💖

---

and that's the whole page, babe 🎀 this was glgrib-egl(1), dated 2026-07-03, and it lives in the glgrib source/version family. read it, love it, no cap 💅✨