glgrib(1)

💖 glgrib — the Unix manual page, but make it cute 💖

okay bestie, pull up a chair, we're reading the glgrib(1) manual together and honestly? it's kind of iconic. 🫶

---

🌸 NAME 🌸

glgrib — display GRIB edition fields using OpenGL. that's it. that's the girl. ✨

---

🎀 SYNOPSIS 🎀

so basically, here's how you call her. review mode first (and yes, you scroll through with PageUp/PageDown):

$ glgrib share/data/diff/ICMSHFCST+0001

just one single field, nothing extra, lowkey minimal:

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

feeling comparative? diff mode:

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

and if you want every option cranked up, full-send mode:

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

bestie, run --help-long if you want the full help. she will tell you everything, no gatekeeping. 👑

---

🦋 DESCRIPTION 🦋

glgrib is an application that displays fields encoded in GRIB edition 2, using OpenGL. yes, actual graphics, actual vibes. 💅

here's the feature set, and it's giving range:

• raster
• contour
• vector
• colorbar
• mapscale
• coastlines
• borders
• Lat/lon, lambert, gaussian grid
• GLFW backend for interactive display, which is glgrib-glfw
• EGL backend, which is glgrib-egl, for batch processing without an X11 display

and she was tested on — shoutout to these graphics cards, they carried:

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 ✨

okay this is the big one, the main character section, the way that this list just keeps going 😭 every single one of these gets a type, a default, and a whole personality. no skipping, we're doing all of them, periodt.

• --border.countries.on — Type: BOOLEAN, Default: TRUE — Display countries.
• --border.lines.color — Type: COLOR, Default: #ffffffff — Coastlines color.
• --border.lines.format — Type: STRING, Default: gshhg — Input format.
• --border.lines.latmax — Type: FLOAT, Default: 0 — Maximum latitude.
• --border.lines.latmin — Type: FLOAT, Default: 0 — Minimum latitude.
• --border.lines.lonmax — Type: FLOAT, Default: 0 — Maximum longitude.
• --border.lines.lonmin — Type: FLOAT, Default: 0 — Minimum longitude.
• --border.lines.path — Type: STRING, Default: coastlines/gshhg/WDBII_bin/wdb_borders_f.b — Path to lines file.
• --border.lines.scale — Type: SCALE, Default: 1.005 — Coastlines scale.
• --border.lines.selector — Type: STRING, Default: "" — Selector.
• --border.lines.visible.on — Type: BOOLEAN, Default: TRUE — Lines are visible.
• --border.on — Type: BOOLEAN, Default: FALSE — Display borders.
• --border.regions.on — Type: BOOLEAN, Default: FALSE — Display regions.
• --border.sea.on — Type: BOOLEAN, Default: FALSE — Display sea borders.
• --cities.labels.font.bitmap.path — Type: PATH, Default: fonts/08.bmp — Bitmap path.
• --cities.labels.font.bitmap.scale — Type: FLOAT, Default: 0.05 — Bitmap scale.
• --cities.labels.font.color.background — Type: COLOR, Default: #00000000 — Background color.
• --cities.labels.font.color.foreground — Type: COLOR, Default: #ffffffff — Foreground color.
• --cities.labels.on — Type: BOOLEAN, Default: FALSE — Enable city names display.
• --cities.on — Type: BOOLEAN, Default: FALSE — Display cities.
• --cities.points.color — Type: COLOR, Default: #ffffffff — Point color.
• --cities.points.palette.colors — Type: COLOR-LIST, Default: "" — Palette colors.
• --cities.points.palette.fixed.on — Type: BOOLEAN, Default: FALSE — Fixed palette.
• --cities.points.palette.generate.levels — Type: INTEGER, Default: 10 — Number of values to generate.
• --cities.points.palette.generate.on — Type: BOOLEAN, Default: FALSE — Generate values.
• --cities.points.palette.linear.on — Type: BOOLEAN, Default: FALSE — Linear colorbar display.
• --cities.points.palette.max — Type: FLOAT, Default: -3.40282e+38 — Palette max value.
• --cities.points.palette.min — Type: FLOAT, Default: 3.40282e+38 — Palette min value.
• --cities.points.palette.name — Type: PALETTE-NAME, Default: none — Palette name.
• --cities.points.palette.ncolors — Type: INTEGER, Default: 256 — Number of colors.
• --cities.points.palette.offset — Type: FLOAT, Default: 0 — Offset for colorbar figures.
• --cities.points.palette.rainbow.direct.on — Type: BOOLEAN, Default: FALSE — Direct/indirect rainbow.
• --cities.points.palette.rainbow.on — Type: BOOLEAN, Default: FALSE — Generate rainbow palette.
• --cities.points.palette.scale — Type: FLOAT, Default: 1 — Scale for colorbar figures.
• --cities.points.palette.values — Type: FLOAT-LIST, Default: "" — Palette values.
• --cities.points.scale — Type: SCALE, Default: 1 — Scale.
• --cities.points.size.value — Type: FLOAT, Default: 1 — Point size.
• --cities.points.size.variable.on — Type: BOOLEAN, Default: FALSE — Enable variable point size.
• --cities.points.visible.on — Type: BOOLEAN, Default: TRUE — Points are visible.
• --coast.lakes.on — Type: BOOLEAN, Default: FALSE — Display lakes coastlines.
• --coast.lines.color — Type: COLOR, Default: #ffffffff — Coastlines color.
• --coast.lines.format — Type: STRING, Default: gshhg — Input format.
• --coast.lines.latmax — Type: FLOAT, Default: 0 — Maximum latitude.
• --coast.lines.latmin — Type: FLOAT, Default: 0 — Minimum latitude.
• --coast.lines.lonmax — Type: FLOAT, Default: 0 — Maximum longitude.
• --coast.lines.lonmin — Type: FLOAT, Default: 0 — Minimum longitude.
• --coast.lines.path — Type: STRING, Default: coastlines/gshhg/GSHHS_bin/gshhs_h.b — Path to lines file.
• --coast.lines.scale — Type: SCALE, Default: 1.005 — Coastlines scale.
• --coast.lines.selector — Type: STRING, Default: "" — Selector.
• --coast.lines.visible.on — Type: BOOLEAN, Default: TRUE — Lines are visible.
• --coast.on — Type: BOOLEAN, Default: FALSE — Display coastlines.
• --colorbar.font.bitmap.path — Type: PATH, Default: fonts/16.bmp — Bitmap path.
• --colorbar.font.bitmap.scale — Type: FLOAT, Default: 0.02 — Bitmap scale.
• --colorbar.font.color.background — Type: COLOR, Default: #00000000 — Background color.
• --colorbar.font.color.foreground — Type: COLOR, Default: #ffffffff — Foreground color.
• --colorbar.format — Type: STRING, Default: %6.4g — Format (sprintf) use to display numbers.
• --colorbar.levels.number — Type: INTEGER, Default: 11 — Colorbar number of levels.
• --colorbar.levels.values — Type: FLOAT-LIST, Default: "" — Colorbar level values.
• --colorbar.on — Type: BOOLEAN, Default: FALSE — Activate colorbar.
• --colorbar.position.xmax — Type: FLOAT, Default: 0.18 — Colorbar xmax.
• --colorbar.position.xmin — Type: FLOAT, Default: 0.08 — Colorbar xmin.
• --colorbar.position.ymax — Type: FLOAT, Default: 0.95 — Colorbar ymax.
• --colorbar.position.ymin — Type: FLOAT, Default: 0.05 — Colorbar ymin.
• --departements.lines.color — Type: COLOR, Default: #ffffffff — Coastlines color.
• --departements.lines.format — Type: STRING, Default: shapeline — Input format.
• --departements.lines.latmax — Type: FLOAT, Default: 0 — Maximum latitude.
• --departements.lines.latmin — Type: FLOAT, Default: 0 — Minimum latitude.
• --departements.lines.lonmax — Type: FLOAT, Default: 0 — Maximum longitude.
• --departements.lines.lonmin — Type: FLOAT, Default: 0 — Minimum longitude.
• --departements.lines.path — Type: STRING, Default: coastlines/departements/departements-20180101.shp — Path to lines file.
• --departements.lines.scale — Type: SCALE, Default: 1.005 — Coastlines scale.
• --departements.lines.selector — Type: STRING, Default: "" — Selector.
• --departements.lines.visible.on — Type: BOOLEAN, Default: TRUE — Lines are visible.
• --departements.on — Type: BOOLEAN, Default: FALSE — Display departements.
• --diff.on — Type: BOOLEAN, Default: FALSE — Enable difference mode.
• --diff.path — Type: STRING-LIST, Default: "" — Files to show in diff mode.
• --field[0].contour.labels.distmin — Type: FLOAT, Default: 3

and yeah, we're cutting off right there — there's so much more where that came from, bestie. this list does not end, she keeps going, and we're gonna read every last crumb of it. 💜

Minimal length in degrees for labelled lines

• --field[0].contour.labels.font.bitmap.path — Type: PATH; Default: fonts/08.bmp; this is literally the bitmap path, bestie 💅
• --field[0].contour.labels.font.bitmap.scale — Type: FLOAT; Default: 0.05; bitmap scale, periodt ✨
• --field[0].contour.labels.font.color.background — Type: COLOR; Default: #00000000; background color, duh 🎀
• --field[0].contour.labels.font.color.foreground — Type: COLOR; Default: #ffffffff; foreground color, slay 🦋
• --field[0].contour.labels.format — Type: STRING; Default: %12.2f; format to print labels, iykyk 🌸
• --field[0].contour.labels.on — Type: BOOLEAN; Default: FALSE; enable labels, bestie 💅
• --field[0].contour.lengths — Type: FLOAT-LIST; Default: ""; list of dash lengths, no cap 🫶
• --field[0].contour.levels — Type: FLOAT-LIST; Default: ""; list of levels, periodt 😭
• --field[0].contour.max — Type: FLOAT; Default: -3.40282e+38; max level, iconic 🔥
• --field[0].contour.min — Type: FLOAT; Default: 3.40282e+38; min level, lowkey 👑
• --field[0].contour.number — Type: INTEGER; Default: 10; number of levels, fr fr 🌈
• --field[0].contour.patterns — Type: STRING-LIST; Default: ""; list of dash patterns, bestie ⭐
• --field[0].contour.widths — Type: FLOAT-LIST; Default: ""; list of widths, periodt 💀
• --field[0].diff.on — Type: BOOLEAN; Default: FALSE; show field difference, slay 🙈
• --field[0].fatal.on — Type: BOOLEAN; Default: FALSE; fatal error if field fails to be created, no pressure 🍓
• --field[0].geometry.check.on — Type: BOOLEAN; Default: FALSE; check geometry, iykyk 🧚
• --field[0].geometry.frame.color1 — Type: COLOR; Default: #ffffffff; first frame color, iconic 💜
• --field[0].geometry.frame.color2 — Type: COLOR; Default: #505050ff; second frame color, periodt 💅
• --field[0].geometry.frame.dlat — Type: FLOAT; Default: 10; latitude interval, bestie ✨
• --field[0].geometry.frame.dlon — Type: FLOAT; Default: 10; longitude interval, slay 🎀
• --field[0].geometry.frame.on — Type: BOOLEAN; Default: FALSE; draw frame around domain, no cap 🦋
• --field[0].geometry.frame.width — Type: FLOAT; Default: 0; frame width, duh 🌸
• --field[0].geometry.gaussian.apply_norm_scale.on — Type: BOOLEAN; Default: TRUE; apply norm scaling, periodt 🫶
• --field[0].geometry.gaussian.fit.on — Type: BOOLEAN; Default: FALSE; fit Gaussian latitude retrieval, iykyk 😭
• --field[0].geometry.gencoords.on — Type: BOOLEAN; Default: FALSE; generate coordinates on GPU when possible, slay 🔥
• --field[0].geometry.height.on — Type: BOOLEAN; Default: FALSE; enable height, bestie 👑
• --field[0].geometry.height.path — Type: FIELD-REF; Default: ""; height field path, periodt 🌈
• --field[0].geometry.height.scale — Type: FLOAT; Default: 0.05; scale to apply to height field, no cap ⭐
• --field[0].geometry.subgrid.on — Type: BOOLEAN; Default: FALSE; create subgrid, iconic 💀
• --field[0].geometry.triangle_strip.on — Type: BOOLEAN; Default: TRUE; enable use of triangle strip, periodt 🙈
• --field[0].hilo.font.bitmap.path — Type: PATH; Default: fonts/08.bmp; bitmap path, bestie 🍓
• --field[0].hilo.font.bitmap.scale — Type: FLOAT; Default: 0.05; bitmap scale, slay 🧚
• --field[0].hilo.font.color.background — Type: COLOR; Default: #00000000; background color, duh 💜
• --field[0].hilo.font.color.foreground — Type: COLOR; Default: #ffffffff; foreground color, periodt 💅
• --field[0].hilo.on — Type: BOOLEAN; Default: FALSE; display low & high, iykyk ✨
• --field[0].hilo.radius — Type: FLOAT; Default: 10; high/low radius in degrees, no cap 🎀
• --field[0].isofill.levels — Type: FLOAT-LIST; Default: ""; list of levels, bestie 🦋
• --field[0].isofill.max — Type: FLOAT; Default: -3.40282e+38; max level, slay 🌸
• --field[0].isofill.min — Type: FLOAT; Default: 3.40282e+38; min level, periodt 🫶
• --field[0].isofill.number — Type: INTEGER; Default: 10; number of levels, fr fr 😭
• --field[0].mpiview.on — Type: BOOLEAN; Default: FALSE; enable MPI view, iconic 🔥
• --field[0].mpiview.path — Type: FIELD-REF; Default: ""; path to MPI distribution field, iykyk 👑
• --field[0].mpiview.scale — Type: FLOAT; Default: 0.1; displacement scale, slay 🌈
• --field[0].no_value_pointer.on — Type: BOOLEAN; Default: FALSE; do not keep field values in memory, periodt ⭐
• --field[0].palette.colors — Type: COLOR-LIST; Default: ""; palette colors, duh 💀
• --field[0].palette.fixed.on — Type: BOOLEAN; Default: FALSE; fixed palette, bestie 🙈
• --field[0].palette.generate.levels — Type: INTEGER; Default: 10; number of values to generate, no cap 🍓
• --field[0].palette.generate.on — Type: BOOLEAN; Default: FALSE; generate values, slay 🧚
• --field[0].palette.linear.on — Type: BOOLEAN; Default: FALSE; linear colorbar display, periodt 💜
• --field[0].palette.max — Type: FLOAT; Default: -3.40282e+38; palette max value, iconic 💅
• --field[0].palette.min — Type: FLOAT; Default: 3.40282e+38; palette min value, lowkey ✨
• --field[0].palette.name — Type: PALETTE-NAME; Default: default; palette name, bestie 🎀
• --field[0].palette.ncolors — Type: INTEGER; Default: 256; number of colors, slay 🦋
• --field[0].palette.offset — Type: FLOAT; Default: 0; offset for colorbar figures, no cap 🌸
• --field[0].palette.rainbow.direct.on — Type: BOOLEAN; Default: FALSE; direct/indirect rainbow, periodt 🫶
• --field[0].palette.rainbow.on — Type: BOOLEAN; Default: FALSE; generate rainbow palette, slay 😭
• --field[0].palette.scale — Type: FLOAT; Default: 1; scale for colorbar figures, iykyk 🔥
• --field[0].palette.values — Type: FLOAT-LIST; Default: ""; palette values, bestie 👑
• --field[0].path — Type: FIELD-REF-LIST; Default: ""; list of GRIB files, no cap 🌈
• --field[0].scalar.discrete.integer.on — Type: BOOLEAN; Default: FALSE; values are integers, periodt ⭐
• --field[0].scalar.discrete.missing_color — Type: COLOR; Default: #00000000; color for missing values, slay 💀
• --field[0].scalar.discrete.on — Type: BOOLEAN; Default: FALSE; plot as a discrete field, iconic 🙈
• --field[0].scalar.light.reverse.b — Type: FLOAT; Default: 0.2; reverse light coefficient, duh 🍓
• --field[0].scalar.light.reverse.c — Type: FLOAT; Default: 15; reverse light coefficient, periodt 🧚
• --field[0].scalar.light.reverse.on — Type: BOOLEAN; Default: FALSE; reverse light, bestie 💜
• --field[0].scalar.pack.bits — Type: INTEGER; Default: 8; number of bytes used to pack field, no cap 💅
• --field[0].scalar.points.on — Type: BOOLEAN; Default: FALSE; display field as points, slay ✨
• --field[0].scalar.points.size.factor.on — Type: BOOLEAN; Default: TRUE; apply scale factor to point size, iykyk 🎀
• --field[0].scalar.points.size.value — Type: FLOAT; Default: 1; field point size, periodt 🦋
• --field[0].scalar.points.size.variable.on — Type: BOOLEAN; Default: FALSE; variable field point size, bestie 🌸
• --field[0].scalar.smooth.on — Type: BOOLEAN; Default: FALSE; smooth scalar fields, slay 🫶
• --field[0].scalar.widen.merge.on — Type: BOOLEAN; Default: FALSE; merge other regions, no cap 😭
• --field[0].scalar.widen.merge.value — Type: FLOAT; Default: 3.40282e+38; merge value, iconic 🔥
• --field[0].scalar.widen.on — Type: BOOLEAN; Default: FALSE; enable region widening, periodt 👑
• --field[0].scalar.widen.radius — Type: INTEGER-LIST; Default: 0; radius for regions, bestie 🌈
• --field[0].scalar.widen.values — Type: FLOAT-LIST; Default: 0; values for regions, slay ⭐
• --field[0].scalar.wireframe.on — Type: BOOLEAN; Default: FALSE; display field as wireframe, duh 💀
• --field[0].scale — Type: SCALE; Default: 1; scales to be applied to fields, iykyk 🙈
• --field[0].stream.density — Type: FLOAT; Default: 1; stream lines density, periodt 🍓
• --field[0].stream.motion.nwaves — Type: FLOAT; Default: 10; number of waves over 1000km, no cap 🧚
• --field[0].stream.motion.on — Type: BOOLEAN; Default: FALSE; enable stream lines motion, bestie 💜
• --field[0].stream.motion.timeaccel — Type: FLOAT; Default: 10000; time acceleration, slay 💅
• --field[0].stream.width — Type: FLOAT; Default: 0; stream lines width, iconic ✨
• --field[0].type
  • Type: FIELD-TYPE
  • Default: SCALAR
  • Description: what kind of field are we even doing — SCALAR, VECTOR, STREAM or CONTOUR 💫
• --field[0].user_pref.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: go look up the field settings in the database, bestie ✨
• --field[0].vector.arrow.color
  • Type: COLOR
  • Default: #ffffffff
  • Description: the color your arrows are serving 🌈
• --field[0].vector.arrow.fill.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: fill the arrow in, no outline-only nonsense
• --field[0].vector.arrow.fixed.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: arrows stay one fixed size, no matter the value
• --field[0].vector.arrow.head_size
  • Type: FLOAT
  • Default: 0.1
  • Description: how chunky the vector head gets 💅
• --field[0].vector.arrow.kind
  • Type: INTEGER
  • Default: 0
  • Description: which arrow kind we're rocking
• --field[0].vector.arrow.min
  • Type: FLOAT
  • Default: 0
  • Description: the minimum vector value
• --field[0].vector.arrow.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: show the arrows, yes please 🏹
• --field[0].vector.barb.angle
  • Type: FLOAT
  • Default: 60
  • Description: the angle of the barbs
• --field[0].vector.barb.circle.level
  • Type: FLOAT
  • Default: 1
  • Description: anything under this value gets a cute lil circle drawn for it ⭕
• --field[0].vector.barb.color
  • Type: COLOR
  • Default: #ffffffff
  • Description: barbs color
• --field[0].vector.barb.dleng
  • Type: FLOAT
  • Default: 0.1
  • Description: barbs length (yes it says length twice, iconique)
• --field[0].vector.barb.length
  • Type: FLOAT
  • Default: 0.25
  • Description: barbs length
• --field[0].vector.barb.levels
  • Type: FLOAT-LIST
  • Default: "0 5 10 15 20 25 "
  • Description: the barbs levels, listed out
• --field[0].vector.barb.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: enable barbs
• --field[0].vector.barb.pennant.levels
  • Type: FLOAT-LIST
  • Default: "0 25 50 75 "
  • Description: the pennants levels 🚩
• --field[0].vector.density
  • Type: FLOAT
  • Default: 50
  • Description: how densely packed the vectors are
• --field[0].vector.norm.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: show the norm field
• --field[0].vector.scale
  • Type: FLOAT
  • Default: 1
  • Description: scale for the vectors
• --field[0].visible.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: is the field visible or is it ghosting us 👻

---

• --geopoints.lat
  • Type: STRING
  • Default: ""
  • Description: name of the latitude field
• --geopoints.lon
  • Type: STRING
  • Default: ""
  • Description: name of the longitude field
• --geopoints.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: display geopoints 📍
• --geopoints.path
  • Type: PATH
  • Default: ""
  • Description: the path, as paths do
• --geopoints.points.color
  • Type: COLOR
  • Default: #ffffffff
  • Description: point color
• --geopoints.points.palette.colors
  • Type: COLOR-LIST
  • Default: ""
  • Description: the palette colors, all of them
• --geopoints.points.palette.fixed.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: lock the palette in place, fixed style
• --geopoints.points.palette.generate.levels
  • Type: INTEGER
  • Default: 10
  • Description: how many values do we generate
• --geopoints.points.palette.generate.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: generate the values ✨
• --geopoints.points.palette.linear.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: linear colorbar display, no curve
• --geopoints.points.palette.max
  • Type: FLOAT
  • Default: -3.40282e+38
  • Description: palette max value
• --geopoints.points.palette.min
  • Type: FLOAT
  • Default: 3.40282e+38
  • Description: palette min value
• --geopoints.points.palette.name
  • Type: PALETTE-NAME
  • Default: none
  • Description: name of the palette 🎨
• --geopoints.points.palette.ncolors
  • Type: INTEGER
  • Default: 256
  • Description: how many colors
• --geopoints.points.palette.offset
  • Type: FLOAT
  • Default: 0
  • Description: offset for the colorbar figures
• --geopoints.points.palette.rainbow.direct.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: direct or indirect rainbow 🌈
• --geopoints.points.palette.rainbow.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: generate a rainbow palette
• --geopoints.points.palette.scale
  • Type: FLOAT
  • Default: 1
  • Description: scale for the colorbar figures
• --geopoints.points.palette.values
  • Type: FLOAT-LIST
  • Default: ""
  • Description: the palette values
• --geopoints.points.scale
  • Type: SCALE
  • Default: 1
  • Description: scale
• --geopoints.points.size.value
  • Type: FLOAT
  • Default: 1
  • Description: how big the points are
• --geopoints.points.size.variable.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: let the point size vary, main character energy only
• --geopoints.points.visible.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: are the points visible
• --geopoints.time.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: make the points show up as time goes on ⏳
• --geopoints.time.rate
  • Type: INTEGER
  • Default: 1
  • Description: how many points get added at each new frame
• --geopoints.val
  • Type: STRING
  • Default: ""
  • Description: name of the value field

---

• --grid.color
  • Type: COLOR
  • Default: #00ff00ff
  • Description: grid color
• --grid.dash_length
  • Type: FLOAT
  • Default: 4
  • Description: dash length, measured in degrees
• --grid.interval
  • Type: INTEGER
  • Default: 2
  • Description: how far apart the non-dashed lines sit
• --grid.labels.angle
  • Type: FLOAT
  • Default: 0
  • Description: angle of the labels
• --grid.labels.font.bitmap.path
  • Type: PATH
  • Default: fonts/08.bmp
  • Description: path to the bitmap
• --grid.labels.font.bitmap.scale
  • Type: FLOAT
  • Default: 0.05
  • Description: scale for the bitmap
• --grid.labels.font.color.background
  • Type: COLOR
  • Default: #00000000
  • Description: background color
• --grid.labels.font.color.foreground
  • Type: COLOR
  • Default: #ffffffff
  • Description: foreground color
• --grid.labels.lat
  • Type: LATITUDE
  • Default: 0
  • Description: latitude of the longitude labels
• --grid.labels.lon
  • Type: LONGITUDE
  • Default: 0
  • Description: longitude of the latitude labels
• --grid.labels.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: enable the labels 🏷️
• --grid.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: display the grid
• --grid.points
  • Type: INTEGER
  • Default: 200
  • Description: how many points run along a parallel
• --grid.resolution
  • Type: INTEGER
  • Default: 9
  • Description: grid resolution
• --grid.scale
  • Type: SCALE
  • Default: 1.005
  • Description: grid scale
• --grid.visible.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: the grid is visible

---

• --land.layers[0].color
  • Type: COLOR
  • Default: #ffe2abff
  • Description: land color 🏝️
• --land.layers[0].on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: enable it
• --land.layers[0].path
  • Type: PATH
  • Default: coastlines/shp/GSHHS_c_L1.shp
  • Description: path to the coastlines
• --land.layers[0].scale
  • Type: SCALE
  • Default: 1
  • Description: scale
• --land.layers[0].selector
  • Type: STRING
  • Default: ""
  • Description: shape selection
• --land.layers[0].subdivision.angle
  • Type: FLOAT
  • Default: 1
  • Description: max angle allowed for subdivision
• --land.layers[0].subdivision.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: enable subdivision
• --land.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: enable land
• --land.visible.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: land is visible

---

• --landscape.color
  • Type: COLOR
  • Default: #00000000
  • Description: color
• --landscape.flat.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: make the Earth flat 🌍 (yes, in the config, not in real life)
• --landscape.geometry.check.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: check the geometry
• --landscape.geometry.frame.color1
  • Type: COLOR
  • Default: #ffffffff
  • Description: first frame color
• --landscape.geometry.frame.color2
  • Type: COLOR
  • Default: #505050ff
  • Description: second frame color
• --landscape.geometry.frame.dlat
  • Type: FLOAT
  • Default: 10
  • Description: latitude interval
• --landscape.geometry.frame.dlon
  • Type: FLOAT
  • Default: 10
  • Description: longitude interval
• --landscape.geometry.frame.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: draw a frame around the domain 🖼️
• --landscape.geometry.frame.width
  • Type: FLOAT
  • Default: 0
  • Description: frame width
• --landscape.geometry.gaussian.apply_norm_scale.on
  • Type: BOOLEAN
  • Default: TRUE
  • Description: apply norm scaling
• --landscape.geometry.gaussian.fit.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: fit the Gaussian latitude retrieval
• --landscape.geometry.gencoords.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: generate coordinates on the GPU when it's possible to do so 🖥️
• --landscape.geometry.height.on
  • Type: BOOLEAN
  • Default: FALSE
  • Description: enable height
• --landscape.geometry.height.path
  • Type: FIELD-REF
  • Default: ""
  • Description: height field path
• --landscape.geometry.height.scale
  • Type: FLOAT
  • Default: 0.05
  • Description: height scale

Description: Scale to apply to height field

• --landscape.geometry.subgrid.on — Type: "BOOLEAN" ✨ Default: "FALSE" 💖 — Create subgrid. it's giving optional extra grid detail, bestie.
• --landscape.geometry.triangle_strip.on — Type: "BOOLEAN" 🌈 Default: "TRUE" 👑 — Enable use of triangle strip. slay those triangles.
• --landscape.grid.number_of_latitudes — Type: "INTEGER" 🔢 Default: 500 💯 — Number of latitudes. all the latitudes, periodt.
• --landscape.grid.path — Type: "STRING" 📁 Default: "" 🫶 — Take geometry from this file. drop the path here, iykyk.
• --landscape.lonlat.position.lat1 — Type: "FLOAT" 🌍 Default: -90 ❄️ — First latitude of display. south pole vibes.
• --landscape.lonlat.position.lat2 — Type: "FLOAT" 🌍 Default: 90 🔥 — Last latitude of display. north pole core.
• --landscape.lonlat.position.lon1 — Type: "FLOAT" 🗺️ Default: -180 🌊 — First longitude of display. left edge, no cap.
• --landscape.lonlat.position.lon2 — Type: "FLOAT" 🗺️ Default: 180 🌅 — Last longitude of display. right edge, fr fr.
• --landscape.on — Type: "BOOLEAN" 🏞️ Default: "FALSE" 🙈 — Enable landscape. turn it on for main character scenery.
• --landscape.path — Type: "STRING" 🖼️ Default: "landscape/Whole_world_-_land_and_oceans_08000.png" 🌍 — Path to landscape image in BMP format. yes, BMP, bestie, keep it exact.
• --landscape.projection — Type: "STRING" 📐 Default: "LONLAT" ✨ — Projection : LONLAT or WEBMERCATOR. pick your projection fantasy.
• --landscape.scale — Type: "SCALE" 📏 Default: 1 💅 — Scale. one is one, periodt.
• --landscape.visible.on — Type: "BOOLEAN" 👀 Default: "TRUE" 🌟 — Landscape is visible. we see it, we stan.
• --landscape.wireframe.on — Type: "BOOLEAN" 🕸️ Default: "FALSE" 💀 — Draw landscape in wireframe mode. retro grid realness, lowkey iconic.
• --mapscale.color1 — Type: "COLOR" 🎨 Default: "#ffffffff" 🤍 — First color. white like a fresh canvas.
• --mapscale.color2 — Type: "COLOR" 🎨 Default: "#505050ff" 🌑 — Second color. dark gray, moody.
• --mapscale.font.bitmap.path — Type: "PATH" 🔤 Default: "fonts/16.bmp" 📁 — Bitmap path. the font file goes here.
• --mapscale.font.bitmap.scale — Type: "FLOAT" 🔍 Default: 0.02 ✨ — Bitmap scale. tiny but fierce.
• --mapscale.font.color.background — Type: "COLOR" 🖌️ Default: "#00000000" 🕳️ — Background color. transparent, not me being invisible.
• --mapscale.font.color.foreground — Type: "COLOR" 🖌️ Default: "#ffffffff" 🤍 — Foreground color. white text, slay.
• --mapscale.on — Type: "BOOLEAN" 🧭 Default: "FALSE" 🙈 — Activate mapscale. flip the switch, bestie.
• --mapscale.position.xmax — Type: "FLOAT" 📍 Default: 0.25 🌸 — Mapscale xmax. right bound, periodt.
• --mapscale.position.xmin — Type: "FLOAT" 📍 Default: 0.05 🌸 — Mapscale xmin. left bound, fr fr.
• --mapscale.position.ymax — Type: "FLOAT" 📍 Default: 0.07 🌸 — Mapscale ymax. top bound, iconic.
• --mapscale.position.ymin — Type: "FLOAT" 📍 Default: 0.05 🌸 — Mapscale ymin. bottom bound, no cap.
• --render.antialiasing.on — Type: "BOOLEAN" ✨ Default: "TRUE" 💖 — Enable antialiasing. smooth edges, we love to see it.
• --render.antialiasing.samples — Type: "INTEGER" 🔢 Default: 4 🌈 — Samples for antialiasing. four samples of pure slay.
• --render.debug.on — Type: "BOOLEAN" 🐛 Default: "FALSE" 🙈 — Enable OpenGL debugging. only if you're ready to read logs, bestie.
• --render.fullscreen.on — Type: "BOOLEAN" 🖥️ Default: "FALSE" 💅 — Window in fullscreen mode. immersion unlocked.
• --render.fullscreen.x.on — Type: "BOOLEAN" ↔️ Default: "FALSE" ✨ — Window in fullscreen mode in X direction. x marks the fullscreen.
• --render.fullscreen.y.on — Type: "BOOLEAN" ↕️ Default: "FALSE" ✨ — Window in fullscreen mode in Y direction. y tho? for fullscreen, obviously.
• --render.height — Type: "INTEGER" 📐 Default: 800 🦋 — Window height. tall energy.
• --render.info.on — Type: "BOOLEAN" ℹ️ Default: "FALSE" 🙈 — Show hardware info. nerd out, iykyk.
• --render.offscreen.format — Type: "STRING" 🖼️ Default: "snapshot_%N.png" 📸 — PNG format output. snapshot naming, no cap.
• --render.offscreen.frames — Type: "INTEGER" 🎞️ Default: 1 💯 — Number of frames to issue in offline mode. one frame or a whole movie, you decide.
• --render.offscreen.on — Type: "BOOLEAN" 📴 Default: "FALSE" 💀 — Run in offline mode. no window, just vibes.
• --render.opengl.version — Type: "FLOAT" 🎮 Default: 4.3 🔥 — OpenGL version. 4.3, iconic.
• --render.position.x — Type: "INTEGER" 📍 Default: -1 🌸 — Window x position. x marks the spot.
• --render.position.y — Type: "INTEGER" 📍 Default: -1 🌸 — Window y position. y tho? for placement, obviously.
• --render.statistics.on — Type: "BOOLEAN" 📊 Default: "FALSE" 🙈 — Issue statistics when window is closed. data dump on exit, periodt.
• --render.title — Type: "STRING" 🏷️ Default: "" 🫶 — Window title. name your window, main character.
• --render.width — Type: "INTEGER" 📐 Default: 800 🦋 — Window width. wide energy.
• --review.on — Type: "BOOLEAN" 👀 Default: "FALSE" 💅 — Enable review mode. review era.
• --review.path — Type: "PATH" 📁 Default: "" 🫶 — File to review. drop the file, bestie.
• --rivers.lines.color — Type: "COLOR" 🎨 Default: "#ffffffff" 🤍 — Coastlines color. the original says coastlines, so we keep it, periodt.
• --rivers.lines.format — Type: "STRING" 📄 Default: "gshhg" 🌊 — Input format. gshhg, iconic.
• --rivers.lines.latmax — Type: "FLOAT" 🌍 Default: 0 ❄️ — Maximum latitude. top of the world.
• --rivers.lines.latmin — Type: "FLOAT" 🌍 Default: 0 ❄️ — Minimum latitude. bottom of the world.
• --rivers.lines.lonmax — Type: "FLOAT" 🗺️ Default: 0 🌊 — Maximum longitude. right edge.
• --rivers.lines.lonmin — Type: "FLOAT" 🗺️ Default: 0 🌊 — Minimum longitude. left edge.
• --rivers.lines.path — Type: "STRING" 📁 Default: "coastlines/gshhg/WDBII_bin/wdb_rivers_f.b" 🌊 — Path to lines file. exact path, no cap.
• --rivers.lines.scale — Type: "SCALE" 📏 Default: 1.005 💅 — Coastlines scale. 1.005, oddly specific but slay.
• --rivers.lines.selector — Type: "STRING" 🔎 Default: "" 🫶 — Selector. pick your selector.
• --rivers.lines.visible.on — Type: "BOOLEAN" 👀 Default: "TRUE" 🌟 — Lines are visible. we see lines.
• --rivers.on — Type: "BOOLEAN" 🌊 Default: "FALSE" 🙈 — Display rivers. river era.
• --scene.center.gridpoint — Type: "INTEGER" 🎯 Default: -1 💅 — Rank of grid point to set focus on. focus, bestie.
• --scene.center.on — Type: "BOOLEAN" 🎯 Default: "FALSE" 🙈 — Center on first field. center yourself, main character.
• --scene.date.font.bitmap.path — Type: "PATH" 🔤 Default: "fonts/08.bmp" 📁 — Bitmap path. font file, iykyk.
• --scene.date.font.bitmap.scale — Type: "FLOAT" 🔍 Default: 0.05 ✨ — Bitmap scale. tiny text, big vibes.
• --scene.date.font.color.background — Type: "COLOR" 🖌️ Default: "#00000000" 🕳️ — Background color. transparent background.
• --scene.date.font.color.foreground — Type: "COLOR" 🖌️ Default: "#ffffffff" 🤍 — Foreground color. white foreground.
• --scene.date.on — Type: "BOOLEAN" 📅 Default: "FALSE" 🙈 — Display date. date display, slay.
• --scene.image.align — Type: "STRING" 🖼️ Default: "" 🫶 — Image alignment. align that image.
• --scene.image.on — Type: "BOOLEAN" 🖼️ Default: "FALSE" 🙈 — Enable image display. image era.
• --scene.image.path — Type: "PATH" 📁 Default: "" 🫶 — Path to image. drop the image path.
• --scene.image.x0 — Type: "FLOAT" 📍 Default: 0 🌸 — Left abscissa. left coordinate.
• --scene.image.x1 — Type: "FLOAT" 📍 Default: 1 🌸 — Right abscissa. right coordinate.
• --scene.image.y0 — Type: "FLOAT" 📍 Default: 0 🌸 — Lower ordinate. lower coordinate.
• --scene.image.y1 — Type: "FLOAT" 📍 Default: 1 🌸 — Upper ordinate. upper coordinate.
• --scene.interpolation.frames — Type: "INTEGER" 🎞️ Default: 10 💯 — Number of frames. ten frames of interpolation.
• --scene.interpolation.on — Type: "BOOLEAN" ✨ Default: "FALSE" 🙈 — Enable interpolation. smooth moves, bestie.
• --scene.light.date — Type: "DATE" 📅 Default: "0000/00/00_00:00:00" 🕛 — Date for sunlight position. exact date string, keep it.
• --scene.light.date_from_grib.on — Type: "BOOLEAN" 📅 Default: "FALSE" 🙈 — Calculate light position from GRIB date. GRIB date energy.
• --scene.light.lat — Type: "LATITUDE" 🌞 Default: 0 ✨ — Light latitude. sun latitude.
• --scene.light.lon — Type: "LONGITUDE" 🌞 Default: 0 ✨ — Light longitude. sun longitude.
• --scene.light.night — Type: "FLOAT" 🌙 Default: 0.1 💀 — Fraction of light during for night. ten percent night light, moody.
• --scene.light.on — Type: "BOOLEAN" 💡 Default: "FALSE" 🙈 — Enable light. let there be light.
• --scene.light.rotate.on — Type: "BOOLEAN" 🔄 Default: "FALSE" 💫 — Make sunlight move. sun with main character energy.
• --scene.light.rotate.rate — Type: "FLOAT" 🔄 Default: 1 ✨ — Rate of rotation : angle/frame. spin rate, periodt.
• --scene.lon_at_hour — Type: "FLOAT" ⏰ Default: -1 🌍 — Set longitude at solar time. solar time vibes.
• --scene.rotate_earth.on — Type: "BOOLEAN" 🌍 Default: "FALSE" 💫 — Make earth rotate. earth spin, iconic.
• --scene.rotate_earth.rate — Type: "FLOAT" 🔄 Default: 1 ✨ — Rate of rotation : angle/frame. spin rate, fr fr.
• --scene.select.field_rank — Type: "INTEGER" 🎯 Default: 0 💅 — Rank of field to select. pick the field.
• --scene.text.a — Type: "STRING-LIST" 📝 Default: "" 🫶 — Text alignment. alignment list, bestie.
• --scene.text.font.bitmap.path — Type: "PATH" 🔤 Default: "fonts/08.bmp" 📁 — Bitmap path. font file again.
• --scene.text.font.bitmap.scale — Type: "FLOAT" 🔍 Default: 0.05 ✨ — Bitmap scale. tiny text scale.
• --scene.text.font.color.background — Type: "COLOR" 🖌️ Default: "#00000000" 🕳️ — Background color. transparent background, no cap.
• --scene.text.font.color.foreground — Type: "COLOR" 🖌️ Default: "#ffffffff" 🤍

okay okay we're back, still deep in the option list, no stopping now 💖 — and that option the last chunk was still in the middle of introducing? Its description is just Foreground color 🎨. Yep. It sets a foreground colour. That's the whole arc. Periodt.

• --scene.text.on — BOOLEAN, default FALSE — turns text on ✍️ literally that, enable text.
• --scene.text.s — STRING-LIST, default "" — the actual strings you want displayed 🎀
• --scene.text.x — FLOAT-LIST, default "" — coordinates of those strings 👀
• --scene.text.y — FLOAT-LIST, default "" — more coordinates of those strings, the other axis bestie ✨

---

• --scene.title.a — STRING, default "NW" — alignment 🧭
• --scene.title.font.bitmap.path — PATH, default "fonts/08.bmp" — bitmap path 🗺️
• --scene.title.font.bitmap.scale — FLOAT, default 0.05 — bitmap scale 🔍
• --scene.title.font.color.background — COLOR, default "#00000000" — background color 🖌️
• --scene.title.font.color.foreground — COLOR, default "#ffffffff" — foreground color 🎨
• --scene.title.on — BOOLEAN, default FALSE — enable title 👑
• --scene.title.text — STRING, default "" — the title itself ✏️
• --scene.title.x — FLOAT, default 0 — coordinates 📍
• --scene.title.y — FLOAT, default 1 — coordinates 📍

---

• --scene.travelling.frames — INTEGER, default 100 — number of frames 🎞️
• --scene.travelling.on — BOOLEAN, default FALSE — enable travelling ✈️
• --scene.travelling.pos1.fov — FLOAT, default 0 — field of view 👁️
• --scene.travelling.pos1.lat — LATITUDE, default 0 — latitude 🌍
• --scene.travelling.pos1.lon — LONGITUDE, default 0 — longitude 🌐
• --scene.travelling.pos2.fov — FLOAT, default 0 — field of view 👁️
• --scene.travelling.pos2.lat — LATITUDE, default 0 — latitude 🌍
• --scene.travelling.pos2.lon — LONGITUDE, default 0 — longitude 🌐

---

• --shell.on — BOOLEAN, default FALSE — run command line 🐚
• --shell.prompt.on — BOOLEAN, default FALSE — start interactive session after batch script completion ⌨️

---

now the tick marks, and there are four whole sides to this thing, so buckle up bestie 🦋

• --ticks.E.dlat — FLOAT, default 10 — latitude interval 📏
• --ticks.E.dlon — FLOAT, default 10 — longitude interval 📏
• --ticks.E.nswe.on — BOOLEAN, default FALSE — North/South/West/East labels instead of +/- 🧭
• --ticks.E.on — BOOLEAN, default TRUE — enable side ✅
• --ticks.N.dlat — FLOAT, default 10 — latitude interval 📏
• --ticks.N.dlon — FLOAT, default 10 — longitude interval 📏
• --ticks.N.nswe.on — BOOLEAN, default FALSE — North/South/West/East labels instead of +/- 🧭
• --ticks.N.on — BOOLEAN, default TRUE — enable side ✅
• --ticks.S.dlat — FLOAT, default 10 — latitude interval 📏
• --ticks.S.dlon — FLOAT, default 10 — longitude interval 📏
• --ticks.S.nswe.on — BOOLEAN, default FALSE — North/South/West/East labels instead of +/- 🧭
• --ticks.S.on — BOOLEAN, default TRUE — enable side ✅
• --ticks.W.dlat — FLOAT, default 10 — latitude interval 📏
• --ticks.W.dlon — FLOAT, default 10 — longitude interval 📏
• --ticks.W.nswe.on — BOOLEAN, default FALSE — North/South/West/East labels instead of +/- 🧭
• --ticks.W.on — BOOLEAN, default TRUE — enable side ✅

---

• --ticks.frame.color — COLOR, default "#ff0000ff" — frame color 🖼️
• --ticks.frame.on — BOOLEAN, default FALSE — enable frame 🖼️
• --ticks.frame.width — FLOAT, default 0.01 — frame width 📐

---

• --ticks.labels.font.bitmap.path — PATH, default "fonts/08.bmp" — bitmap path 🗺️
• --ticks.labels.font.bitmap.scale — FLOAT, default 0.02 — bitmap scale 🔍
• --ticks.labels.font.color.background — COLOR, default "#00000000" — background color 🖌️
• --ticks.labels.font.color.foreground — COLOR, default "#ffffffff" — foreground color 🎨
• --ticks.labels.format — STRING, default "%+06.2f" — format for tick labels 🔢
• --ticks.labels.on — BOOLEAN, default FALSE — display tick labels 🔤

---

• --ticks.lines.color — COLOR, default "#ffffffff" — tick color 🎨
• --ticks.lines.kind — INTEGER, default 0 — tick kind 🧩
• --ticks.lines.length — FLOAT, default 0.025 — tick length 📏
• --ticks.lines.on — BOOLEAN, default FALSE — display ticks ✨
• --ticks.lines.width — FLOAT, default 0.01 — tick width 📐
• --ticks.visible.on — BOOLEAN, default TRUE — ticks are visible 👀

---

and now the camera stuff, aka the main character section of this whole manpage 📸

• --view.center.on — BOOLEAN, default TRUE — center view 🎯
• --view.clip.dlat — FLOAT, default 5 — amount of latitude to clip ✂️
• --view.clip.dlon — FLOAT, default 10 — amount of longitude to clip ✂️
• --view.clip.on — BOOLEAN, default TRUE — enable Mercator and lat/lon clipping ✂️
• --view.clip.xmax — FLOAT, default 1 — max viewport x coordinate 📍
• --view.clip.xmin — FLOAT, default 0 — min viewport x coordinate 📍
• --view.clip.ymax — FLOAT, default 1 — max viewport y coordinate 📍
• --view.clip.ymin — FLOAT, default 0 — min viewport y coordinate 📍
• --view.distance — FLOAT, default 6 — camera distance 📷
• --view.fov — ANGLE, default 20 — camera field of view 👁️
• --view.lat — LATITUDE, default 0 — camera latitude 🌍
• --view.lon — LONGITUDE, default 0 — camera longitude 🌐
• --view.pitch — ANGLE, default 0 — camera pitch 🎥
• --view.projection — PROJECTION, default "XYZ" — the options are Mercator, XYZ, latlon, polar_north, polar_south 🗺️
• --view.roll — ANGLE, default 0 — camera roll 🎥
• --view.trans.matrix — FLOAT-LIST, default "" — transformation matrix values 🧮
• --view.trans.on — BOOLEAN, default FALSE — enable transformation matrix 🧮
• --view.transformation — TRANSFORMATION, default "PERSPECTIVE" — perspective or orthographic 🪞
• --view.yaw — ANGLE, default 0 — camera yaw 🎥
• --view.zoom.lat — LATITUDE, default 46.7 — latitude of zoom 🔎
• --view.zoom.lon — LONGITUDE, default 2 — longitude of zoom 🔎
• --view.zoom.on — BOOLEAN, default FALSE — enable zoom with Schmidt transform 🔎
• --view.zoom.stretch — FLOAT, default 0.5 — stretching factor 🪢

---

🌈 SEE ALSO

• 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) — the icon who wrote all of this, we stan 💜

---

and that's the whole page, bestie, we ate and left no crumbs 🫶 this was the glgrib(1) manual as of 2026-07-03. go forth and render something gorgeous 🌸✨