glgrib-glfw(1)

glgrib-glfw(1) — Display GRIB edition fields using OpenGL 👑

Hey bestie! Welcome to the manual for glgrib-glfw 💖 This is the GLFW backend for interactive display, and we're about to spill all the tea ☕. It's giving main character energy ✨

---

✨ NAME ✨

glgrib — Display GRIB edition fields using OpenGL 🌈

✨ SYNOPSIS ✨

Okay so here's how you run it, depending on the vibe you're going for:

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. No cap, it's literally that iconic 💅

Features include: raster, contour, vector, colorbar, mapscale, coastlines, borders. It handles Lat/lon, lambert, gaussian grid. There's a GLFW backend for interactive display (that's glgrib-glfw, hey girl hey) and an EGL backend (glgrib-egl) for batch processing without X11 display. Both are slaying.

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 ✨

Okay, this is the big one. Every option, every default, every little detail. Let's get into it. 🧚✨

• --border.countries.on — Type: BOOLEAN; Default: "TRUE"; Description: Shows countries on the map, fr fr 🌍
• --border.lines.color — Type: COLOR; Default: "#ffffffff"; Description: The color of coastlines, no cap 🎨
• --border.lines.format — Type: STRING; Default: "gshhg"; Description: Input format, defaults to gshhg 📂
• --border.lines.latmax — Type: FLOAT; Default: 0; Description: Top latitude limit ⬆️
• --border.lines.latmin — Type: FLOAT; Default: 0; Description: Bottom latitude limit ⬇️
• --border.lines.lonmax — Type: FLOAT; Default: 0; Description: Right longitude limit ➡️
• --border.lines.lonmin — Type: FLOAT; Default: 0; Description: Left longitude limit ⬅️
• --border.lines.path — Type: STRING; Default: "coastlines/gshhg/WDBII_bin/wdb_borders_f.b"; Description: Where the lines file lives 📁
• --border.lines.scale — Type: SCALE; Default: 1.005; Description: Scale factor for coastlines 🔍
• --border.lines.selector — Type: STRING; Default: ""; Description: Selector string, empty by default 🎯
• --border.lines.visible.on — Type: BOOLEAN; Default: "TRUE"; Description: Whether lines are visible, bestie 👀
• --border.on — Type: BOOLEAN; Default: "FALSE"; Description: Turns borders on/off 🖼️
• --border.regions.on — Type: BOOLEAN; Default: "FALSE"; Description: Shows regions 🗺️
• --border.sea.on — Type: BOOLEAN; Default: "FALSE"; Description: Shows sea borders 🌊
• --cities.labels.font.bitmap.path — Type: PATH; Default: "fonts/08.bmp"; Description: Path to the bitmap font 🔤
• --cities.labels.font.bitmap.scale — Type: FLOAT; Default: 0.05; Description: Scale of the bitmap font 🔎
• --cities.labels.font.color.background — Type: COLOR; Default: "#00000000"; Description: Background color for labels 🎨
• --cities.labels.font.color.foreground — Type: COLOR; Default: "#ffffffff"; Description: Foreground color for labels 🖌️
• --cities.labels.on — Type: BOOLEAN; Default: "FALSE"; Description: Turns city name display on/off 🏙️
• --cities.on — Type: BOOLEAN; Default: "FALSE"; Description: Shows cities 🌆
• --cities.points.color — Type: COLOR; Default: "#ffffffff"; Description: Color of city points 🔴
• --cities.points.palette.colors — Type: COLOR-LIST; Default: ""; Description: List of palette colors 🌈
• --cities.points.palette.fixed.on — Type: BOOLEAN; Default: "FALSE"; Description: Use a fixed palette 📌
• --cities.points.palette.generate.levels — Type: INTEGER; Default: 10; Description: How many values to generate 🔢
• --cities.points.palette.generate.on — Type: BOOLEAN; Default: "FALSE"; Description: Generate palette values ⚙️
• --cities.points.palette.linear.on — Type: BOOLEAN; Default: "FALSE"; Description: Display a linear colorbar 📊
• --cities.points.palette.max — Type: FLOAT; Default: -3.40282e+38; Description: Maximum palette value ⬆️
• --cities.points.palette.min — Type: FLOAT; Default: 3.40282e+38; Description: Minimum palette value ⬇️
• --cities.points.palette.name — Type: PALETTE-NAME; Default: "none"; Description: Name of the palette 🏷️
• --cities.points.palette.ncolors — Type: INTEGER; Default: 256; Description: Number of colors in the palette 🎨
• --cities.points.palette.offset — Type: FLOAT; Default: 0; Description: Offset for colorbar numbers 📏
• --cities.points.palette.rainbow.direct.on — Type: BOOLEAN; Default: "FALSE"; Description: Direct or indirect rainbow 🌈
• --cities.points.palette.rainbow.on — Type: BOOLEAN; Default: "FALSE"; Description: Generate a rainbow palette 🌈
• --cities.points.palette.scale — Type: FLOAT; Default: 1; Description: Scale for colorbar numbers 📐
• --cities.points.palette.values — Type: FLOAT-LIST; Default: ""; Description: List of palette values 📊
• --cities.points.scale — Type: SCALE; Default: 1; Description: Scale factor 🔍
• --cities.points.size.value — Type: FLOAT; Default: 1; Description: Size of points 🔵
• --cities.points.size.variable.on — Type: BOOLEAN; Default: "FALSE"; Description: Variable point size on/off 📈
• --cities.points.visible.on — Type: BOOLEAN; Default: "TRUE"; Description: Whether points are visible 👀
• --coast.lakes.on — Type: BOOLEAN; Default: "FALSE"; Description: Shows lake coastlines 🏞️
• --coast.lines.color — Type: COLOR; Default: "#ffffffff"; Description: Color for coastlines 🎨
• --coast.lines.format — Type: STRING; Default: "gshhg"; Description: Input format 📂
• --coast.lines.latmax — Type: FLOAT; Default: 0; Description: Top latitude limit ⬆️
• --coast.lines.latmin — Type: FLOAT; Default: 0; Description: Bottom latitude limit ⬇️
• --coast.lines.lonmax — Type: FLOAT; Default: 0; Description: Right longitude limit ➡️
• --coast.lines.lonmin — Type: FLOAT; Default: 0; Description: Left longitude limit ⬅️
• --coast.lines.path — Type: STRING; Default: "coastlines/gshhg/GSHHS_bin/gshhs_h.b"; Description: Path to coastlines file 📁
• --coast.lines.scale — Type: SCALE; Default: 1.005; Description: Scale factor for coastlines 🔍
• --coast.lines.selector — Type: STRING; Default: ""; Description: Selector string 🎯
• --coast.lines.visible.on — Type: BOOLEAN; Default: "TRUE"; Description: Whether lines are visible 👀
• --coast.on — Type: BOOLEAN; Default: "FALSE"; Description: Turns coastlines on/off 🏖️
• --colorbar.font.bitmap.path — Type: PATH; Default: "fonts/16.bmp"; Description: Path to bitmap font for colorbar 🔤
• --colorbar.font.bitmap.scale — Type: FLOAT; Default: 0.02; Description: Scale of the bitmap font 🔎
• --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: sprintf format used to display numbers 🔢
• --colorbar.levels.number — Type: INTEGER; Default: 11; Description: Number of colorbar levels 📊
• --colorbar.levels.values — Type: FLOAT-LIST; Default: ""; Description: Values for colorbar levels 📈
• --colorbar.on — Type: BOOLEAN; Default: "FALSE"; Description: Turns colorbar on/off 🌈
• --colorbar.position.xmax — Type: FLOAT; Default: 0.18; Description: Colorbar xmax position ➡️
• --colorbar.position.xmin — Type: FLOAT; Default: 0.08; Description: Colorbar xmin position ⬅️
• --colorbar.position.ymax — Type: FLOAT; Default: 0.95; Description: Colorbar ymax position ⬆️
• --colorbar.position.ymin — Type: FLOAT; Default: 0.05; Description: Colorbar ymin position ⬇️
• --departements.lines.color — Type: COLOR; Default: "#ffffffff"; Description: Color for coastlines (yep, it says coastlines) 🎨
• --departements.lines.format — Type: STRING; Default: "shapeline"; Description: Input format 📂
• --departements.lines.latmax — Type: FLOAT; Default: 0; Description: Top latitude limit ⬆️
• --departements.lines.latmin — Type: FLOAT; Default: 0; Description: Bottom latitude limit ⬇️
• --departements.lines.lonmax — Type: FLOAT; Default: 0; Description: Right longitude limit ➡️
• --departements.lines.lonmin — Type: FLOAT; Default: 0; Description: Left longitude limit ⬅️
• --departements.lines.path — Type: STRING; Default: "coastlines/departements/departements-20180101.shp"; Description: Path to departements lines file 📁
• --departements.lines.scale — Type: SCALE; Default: 1.005; Description: Scale factor for coastlines 🔍
• --departements.lines.selector — Type: STRING; Default: ""; Description: Selector string 🎯
• --departements.lines.visible.on — Type: BOOLEAN; Default: "TRUE"; Description: Whether lines are visible 👀
• --departements.on — Type: BOOLEAN; Default: "FALSE"; Description: Shows departements 🗺️
• --diff.on — Type: BOOLEAN; Default: "FALSE"; Description: Turns on difference mode 🔄
• --diff.path — Type: STRING-LIST; Default: ""; Description: Files to show in diff mode 📂
• --field[0].contour.labels.distmin — Type: FLOAT; Default: 3
• --field[0].contour.labels.font.bitmap.path — type PATH, default fonts/08.bmp. Where the label bitmap lives 💖
• --field[0].contour.labels.font.bitmap.scale — type FLOAT, default 0.05. How big the bitmap goes 🎀
• --field[0].contour.labels.font.color.background — type COLOR, default #00000000. The background color, bestie 🌸
• --field[0].contour.labels.font.color.foreground — type COLOR, default #ffffffff. The foreground color, slay ✨
• --field[0].contour.labels.format — type STRING, default %12.2f. The format used to print labels fr fr
• --field[0].contour.labels.on — type BOOLEAN, default FALSE. Turns labels on 💅
• --field[0].contour.lengths — type FLOAT-LIST, default "". A list of dash lengths 🔥
• --field[0].contour.levels — type FLOAT-LIST, default "". A list of levels ⭐
• --field[0].contour.max — type FLOAT, default -3.40282e+38. The max level 👑
• --field[0].contour.min — type FLOAT, default 3.40282e+38. The min level 💜
• --field[0].contour.number — type INTEGER, default 10. How many levels you want 🌈
• --field[0].contour.patterns — type STRING-LIST, default "". A list of dash patterns 🦋
• --field[0].contour.widths — type FLOAT-LIST, default "". A list of widths 🍓
• --field[0].diff.on — type BOOLEAN, default FALSE. Shows the field difference 🧚
• --field[0].fatal.on — type BOOLEAN, default FALSE. Fatal error if the field fails to be created 😭
• --field[0].geometry.check.on — type BOOLEAN, default FALSE. Checks the geometry 💀
• --field[0].geometry.frame.color1 — type COLOR, default #ffffffff. First frame color ✨
• --field[0].geometry.frame.color2 — type COLOR, default #505050ff. Second frame color 🌸
• --field[0].geometry.frame.dlat — type FLOAT, default 10. Latitude interval 💖
• --field[0].geometry.frame.dlon — type FLOAT, default 10. Longitude interval 🎀
• --field[0].geometry.frame.on — type BOOLEAN, default FALSE. Draws a frame around the domain 💅
• --field[0].geometry.frame.width — type FLOAT, default 0. Frame width 🔥
• --field[0].geometry.gaussian.apply_norm_scale.on — type BOOLEAN, default TRUE. Applies norm scaling 👑
• --field[0].geometry.gaussian.fit.on — type BOOLEAN, default FALSE. Fits Gaussian latitude retrieval ⭐
• --field[0].geometry.gencoords.on — type BOOLEAN, default FALSE. Generates coordinates on the GPU when possible 💜
• --field[0].geometry.height.on — type BOOLEAN, default FALSE. Enables height 🌈
• --field[0].geometry.height.path — type FIELD-REF, default "". Height field path 🦋
• --field[0].geometry.height.scale — type FLOAT, default 0.05. Scale to apply to the height field 🍓
• --field[0].geometry.subgrid.on — type BOOLEAN, default FALSE. Creates a subgrid 🧚
• --field[0].geometry.triangle_strip.on — type BOOLEAN, default TRUE. Enables use of triangle strip 😭
• --field[0].hilo.font.bitmap.path — type PATH, default fonts/08.bmp. Bitmap path 💀
• --field[0].hilo.font.bitmap.scale — type FLOAT, default 0.05. Bitmap scale ✨
• --field[0].hilo.font.color.background — type COLOR, default #00000000. Background color 🌸
• --field[0].hilo.font.color.foreground — type COLOR, default #ffffffff. Foreground color 💖
• --field[0].hilo.on — type BOOLEAN, default FALSE. Displays low & high 🎀
• --field[0].hilo.radius — type FLOAT, default 10. High/low radius in degrees 💅
• --field[0].isofill.levels — type FLOAT-LIST, default "". List of levels 🔥
• --field[0].isofill.max — type FLOAT, default -3.40282e+38. Max level 👑
• --field[0].isofill.min — type FLOAT, default 3.40282e+38. Min level ⭐
• --field[0].isofill.number — type INTEGER, default 10. Number of levels 💜
• --field[0].mpiview.on — type BOOLEAN, default FALSE. Enables MPI view 🌈
• --field[0].mpiview.path — type FIELD-REF, default "". Path to the MPI distribution field 🦋
• --field[0].mpiview.scale — type FLOAT, default 0.1. Displacement scale 🍓
• --field[0].no_value_pointer.on — type BOOLEAN, default FALSE. Do not keep field values in memory 🧚
• --field[0].palette.colors — type COLOR-LIST, default "". Palette colors 😭
• --field[0].palette.fixed.on — type BOOLEAN, default FALSE. Fixed palette 💀
• --field[0].palette.generate.levels — type INTEGER, default 10. Number of values to generate ✨
• --field[0].palette.generate.on — type BOOLEAN, default FALSE. Generate values 🌸
• --field[0].palette.linear.on — type BOOLEAN, default FALSE. Linear colorbar display 💖
• --field[0].palette.max — type FLOAT, default -3.40282e+38. Palette max value 🎀
• --field[0].palette.min — type FLOAT, default 3.40282e+38. Palette min value 💅
• --field[0].palette.name — type PALETTE-NAME, default default. Palette name 🔥
• --field[0].palette.ncolors — type INTEGER, default 256. Number of colors 👑
• --field[0].palette.offset — type FLOAT, default 0. Offset for colorbar figures ⭐
• --field[0].palette.rainbow.direct.on — type BOOLEAN, default FALSE. Direct/indirect rainbow 💜
• --field[0].palette.rainbow.on — type BOOLEAN, default FALSE. Generate rainbow palette 🌈
• --field[0].palette.scale — type FLOAT, default 1. Scale for colorbar figures 🦋
• --field[0].palette.values — type FLOAT-LIST, default "". Palette values 🍓
• --field[0].path — type FIELD-REF-LIST, default "". List of GRIB files 🧚
• --field[0].scalar.discrete.integer.on — type BOOLEAN, default FALSE. Values are integers 😭
• --field[0].scalar.discrete.missing_color — type COLOR, default #00000000. Color for missing values 💀
• --field[0].scalar.discrete.on — type BOOLEAN, default FALSE. Plot as a discrete field ✨
• --field[0].scalar.light.reverse.b — type FLOAT, default 0.2. Reverse light coefficient 🌸
• --field[0].scalar.light.reverse.c — type FLOAT, default 15. Reverse light coefficient 💖
• --field[0].scalar.light.reverse.on — type BOOLEAN, default FALSE. Reverse light 🎀
• --field[0].scalar.pack.bits — type INTEGER, default 8. Number of bytes used to pack field 💅
• --field[0].scalar.points.on — type BOOLEAN, default FALSE. Display field as points 🔥
• --field[0].scalar.points.size.factor.on — type BOOLEAN, default TRUE. Apply scale factor to point size 👑
• --field[0].scalar.points.size.value — type FLOAT, default 1. Field point size ⭐
• --field[0].scalar.points.size.variable.on — type BOOLEAN, default FALSE. Variable field point size 💜
• --field[0].scalar.smooth.on — type BOOLEAN, default FALSE. Smooth scalar fields 🌈
• --field[0].scalar.widen.merge.on — type BOOLEAN, default FALSE. Merge other regions 🦋
• --field[0].scalar.widen.merge.value — type FLOAT, default 3.40282e+38. Merge value 🍓
• --field[0].scalar.widen.on — type BOOLEAN, default FALSE. Enable region widening 🧚
• --field[0].scalar.widen.radius — type INTEGER-LIST, default 0. Radius for regions 😭
• --field[0].scalar.widen.values — type FLOAT-LIST, default 0. Values for regions 💀
• --field[0].scalar.wireframe.on — type BOOLEAN, default FALSE. Display field as wireframe ✨
• --field[0].scale — type SCALE, default 1. Scales to be applied to fields 🌸
• --field[0].stream.density — type FLOAT, default 1. Stream lines density 💖
• --field[0].stream.motion.nwaves — type FLOAT, default 10. Number of waves over 1000km 🎀
• --field[0].stream.motion.on — type BOOLEAN, default FALSE. Enable stream lines motion 💅
• --field[0].stream.motion.timeaccel — type FLOAT, default 10000. Time acceleration 🔥
• --field[0].stream.width — type FLOAT, default 0. Stream lines width 👑

still in the OPTIONS mines, bestie — the config goblin has more for us, and it's giving detail 💅

• "--field[0].type" — what kind of field are we even on? it's giving SCALAR, VECTOR, STREAM, or CONTOUR 🦋 pick your fighter.
  • Type: "FIELD-TYPE"
  • Default: "SCALAR"
• "--field[0].user_pref.on" — should we go look up field settings in the database? yes pls, that's the vibe.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--field[0].vector.arrow.color" — color for the arrows, obviously. default is that full white #ffffffff.
  • Type: "COLOR"
  • Default: "#ffffffff"
• "--field[0].vector.arrow.fill.on" — fill the arrow? iconic.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--field[0].vector.arrow.fixed.on" — fixed-size arrow, no scaling drama.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--field[0].vector.arrow.head_size" — vector head size, obvi.
  • Type: "FLOAT"
  • Default: 0.1
• "--field[0].vector.arrow.kind" — arrow kind. mysterious but okay.
  • Type: "INTEGER"
  • Default: 0
• "--field[0].vector.arrow.min" — vector min value.
  • Type: "FLOAT"
  • Default: 0
• "--field[0].vector.arrow.on" — show arrows? yes bestie, show them 💅
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--field[0].vector.barb.angle" — barbs angle. geometry queen.
  • Type: "FLOAT"
  • Default: 60
• "--field[0].vector.barb.circle.level" — value under which we draw a circle. lowkey dramatic.
  • Type: "FLOAT"
  • Default: 1
• "--field[0].vector.barb.color" — barbs color. white again.
  • Type: "COLOR"
  • Default: "#ffffffff"
• "--field[0].vector.barb.dleng" — barbs length. wait, there are two length options? yes. this is dleng.
  • Type: "FLOAT"
  • Default: 0.1
• "--field[0].vector.barb.length" — barbs length. the other one. 💀
  • Type: "FLOAT"
  • Default: 0.25
• "--field[0].vector.barb.levels" — barbs levels. a whole list: 0 5 10 15 20 25 (yes, trailing space).
  • Type: "FLOAT-LIST"
  • Default: "0 5 10 15 20 25 "
• "--field[0].vector.barb.on" — enable barbs? currently off, but you do you.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--field[0].vector.barb.pennant.levels" — pennants levels. list: 0 25 50 75 (trailing space too).
  • Type: "FLOAT-LIST"
  • Default: "0 25 50 75 "
• "--field[0].vector.density" — vector density. how crowded we feeling?
  • Type: "FLOAT"
  • Default: 50
• "--field[0].vector.norm.on" — show norm field? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--field[0].vector.scale" — vector scale. make it bigger or smaller.
  • Type: "FLOAT"
  • Default: 1
• "--field[0].visible.on" — field is visible? yes bestie, main character energy ✨
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--geopoints.lat" — latitude field name. empty by default.
  • Type: "STRING"
  • Default: ""
• "--geopoints.lon" — longitude field name. also empty.
  • Type: "STRING"
  • Default: ""
• "--geopoints.on" — display geopoints? not rn, default false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.path" — path. to what? geopoints, presumably. empty default.
  • Type: "PATH"
  • Default: ""
• "--geopoints.points.color" — point color. white.
  • Type: "COLOR"
  • Default: "#ffffffff"
• "--geopoints.points.palette.colors" — palette colors. a list? empty default.
  • Type: "COLOR-LIST"
  • Default: ""
• "--geopoints.points.palette.fixed.on" — fixed palette? no thanks.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.palette.generate.levels" — number of values to generate. default 10.
  • Type: "INTEGER"
  • Default: 10
• "--geopoints.points.palette.generate.on" — generate values? false by default.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.palette.linear.on" — linear colorbar display? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.palette.max" — palette max value. huge negative number: -3.40282e+38.
  • Type: "FLOAT"
  • Default: -3.40282e+38
• "--geopoints.points.palette.min" — palette min value. huge positive: 3.40282e+38.
  • Type: "FLOAT"
  • Default: 3.40282e+38
• "--geopoints.points.palette.name" — palette name. default none.
  • Type: "PALETTE-NAME"
  • Default: "none"
• "--geopoints.points.palette.ncolors" — number of colors. 256, iconic.
  • Type: "INTEGER"
  • Default: 256
• "--geopoints.points.palette.offset" — offset for colorbar figures.
  • Type: "FLOAT"
  • Default: 0
• "--geopoints.points.palette.rainbow.direct.on" — direct/indirect rainbow? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.palette.rainbow.on" — generate rainbow palette? not by default.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.palette.scale" — scale for colorbar figures.
  • Type: "FLOAT"
  • Default: 1
• "--geopoints.points.palette.values" — palette values. empty list.
  • Type: "FLOAT-LIST"
  • Default: ""
• "--geopoints.points.scale" — scale. just scale.
  • Type: "SCALE"
  • Default: 1
• "--geopoints.points.size.value" — point size. default 1.
  • Type: "FLOAT"
  • Default: 1
• "--geopoints.points.size.variable.on" — enable variable point size? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.points.visible.on" — points are visible? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--geopoints.time.on" — make points appear with time? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--geopoints.time.rate" — number of points to add at each new frame. default 1.
  • Type: "INTEGER"
  • Default: 1
• "--geopoints.val" — value field name. empty.
  • Type: "STRING"
  • Default: ""
• "--grid.color" — grid color. default green #00ff00ff.
  • Type: "COLOR"
  • Default: "#00ff00ff"
• "--grid.dash_length" — dash length in degrees. default 4.
  • Type: "FLOAT"
  • Default: 4
• "--grid.interval" — interval between non dashed lines. default 2.
  • Type: "INTEGER"
  • Default: 2
• "--grid.labels.angle" — angle of labels. default 0.
  • Type: "FLOAT"
  • Default: 0
• "--grid.labels.font.bitmap.path" — bitmap path. fonts/08.bmp.
  • Type: "PATH"
  • Default: "fonts/08.bmp"
• "--grid.labels.font.bitmap.scale" — bitmap scale. 0.05.
  • Type: "FLOAT"
  • Default: 0.05
• "--grid.labels.font.color.background" — background color. transparent black #00000000.
  • Type: "COLOR"
  • Default: "#00000000"
• "--grid.labels.font.color.foreground" — foreground color. white #ffffffff.
  • Type: "COLOR"
  • Default: "#ffffffff"
• "--grid.labels.lat" — latitude of longitude labels. default 0.
  • Type: "LATITUDE"
  • Default: 0
• "--grid.labels.lon" — longitude of latitude labels. default 0.
  • Type: "LONGITUDE"
  • Default: 0
• "--grid.labels.on" — enable labels? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--grid.on" — display grid? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--grid.points" — number of points along a parallel. default 200.
  • Type: "INTEGER"
  • Default: 200
• "--grid.resolution" — grid resolution. default 9.
  • Type: "INTEGER"
  • Default: 9
• "--grid.scale" — grid scale. default 1.005.
  • Type: "SCALE"
  • Default: 1.005
• "--grid.visible.on" — grid is visible? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--land.layers[0].color" — land color. default #ffe2abff.
  • Type: "COLOR"
  • Default: "#ffe2abff"
• "--land.layers[0].on" — enable? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--land.layers[0].path" — path to coastlines. coastlines/shp/GSHHS_c_L1.shp.
  • Type: "PATH"
  • Default: "coastlines/shp/GSHHS_c_L1.shp"
• "--land.layers[0].scale" — scale. default 1.
  • Type: "SCALE"
  • Default: 1
• "--land.layers[0].selector" — shape selection. empty.
  • Type: "STRING"
  • Default: ""
• "--land.layers[0].subdivision.angle" — angle max for subdivision. default 1.
  • Type: "FLOAT"
  • Default: 1
• "--land.layers[0].subdivision.on" — enable subdivision? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--land.on" — enable land? false by default.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--land.visible.on" — land is visible? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--landscape.color" — color. transparent black #00000000.
  • Type: "COLOR"
  • Default: "#00000000"
• "--landscape.flat.on" — make Earth flat? true, flat earth era /j.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--landscape.geometry.check.on" — check geometry? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--landscape.geometry.frame.color1" — first frame color. white.
  • Type: "COLOR"
  • Default: "#ffffffff"
• "--landscape.geometry.frame.color2" — second frame color. #505050ff.
  • Type: "COLOR"
  • Default: "#505050ff"
• "--landscape.geometry.frame.dlat" — latitude interval. default 10.
  • Type: "FLOAT"
  • Default: 10
• "--landscape.geometry.frame.dlon" — longitude interval. default 10.
  • Type: "FLOAT"
  • Default: 10
• "--landscape.geometry.frame.on" — draw frame around domain? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--landscape.geometry.frame.width" — frame width. default 0.
  • Type: "FLOAT"
  • Default: 0
• "--landscape.geometry.gaussian.apply_norm_scale.on" — apply norm scaling? yes.
  • Type: "BOOLEAN"
  • Default: "TRUE"
• "--landscape.geometry.gaussian.fit.on" — fit Gaussian latitude retrieval? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--landscape.geometry.gencoords.on" — generate coordinates on GPU when possible? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--landscape.geometry.height.on" — enable height? false.
  • Type: "BOOLEAN"
  • Default: "FALSE"
• "--landscape.geometry.height.path" — height field path. empty.
  • Type: "FIELD-REF"
  • Default: ""
• "--landscape.geometry.height.scale"
  • Type: "FLOAT"
  • Default: 0.05

Okay so picking right back up where we left off, last thing on the docket for the landscape geometry: Scale to apply to height field — that's the scale factor you slap onto the height field. Vibes only, it's just a scale. 💅

• --landscape.geometry.subgrid.on — type "BOOLEAN", default "FALSE" → create a subgrid
• --landscape.geometry.triangle_strip.on — type "BOOLEAN", default "TRUE" → turn on use of triangle strip (already on, she's already thriving ✨)
• --landscape.grid.number_of_latitudes — type "INTEGER", default 500 → number of latitudes
• --landscape.grid.path — type "STRING", default "" → take the geometry from this file
• --landscape.lonlat.position.lat1 — type "FLOAT", default -90 → first latitude of display
• --landscape.lonlat.position.lat2 — type "FLOAT", default 90 → last latitude of display
• --landscape.lonlat.position.lon1 — type "FLOAT", default -180 → first longitude of display
• --landscape.lonlat.position.lon2 — type "FLOAT", default 180 → last longitude of display
• --landscape.on — type "BOOLEAN", default "FALSE" → enable landscape
• --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" → projection: LONLAT or WEBMERCATOR
• --landscape.scale — type "SCALE", default 1 → scale
• --landscape.visible.on — type "BOOLEAN", default "TRUE" → landscape is visible 👀
• --landscape.wireframe.on — type "BOOLEAN", default "FALSE" → draw the landscape in wireframe mode

---

Mapscale time, bestie 🎀:

• --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" → activate 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

---

Render settings, aka the glow-up department 🌈:

• --render.antialiasing.on — type "BOOLEAN", default "TRUE" → enable antialiasing
• --render.antialiasing.samples — type "INTEGER", default 4 → samples for antialiasing
• --render.debug.on — type "BOOLEAN", default "FALSE" → enable OpenGL debugging
• --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" → show hardware info
• --render.offscreen.format — type "STRING", default "snapshot_%N.png" → 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" → run in offline mode
• --render.opengl.version — type "FLOAT", default 4.3 → 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" → issue statistics when the window is closed
• --render.title — type "STRING", default "" → window title
• --render.width — type "INTEGER", default 800 → window width

---

Review mode, short but iconic 💅:

• --review.on — type "BOOLEAN", default "FALSE" → enable review mode
• --review.path — type "PATH", default "" → file to review

---

Rivers 🏞️ (and yes, a bunch of these say "Coastlines" in the description, no I'm not messing with it, that's literally what the page says, iykyk):

• --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 "" → selector
• --rivers.lines.visible.on — type "BOOLEAN", default "TRUE" → lines are visible
• --rivers.on — type "BOOLEAN", default "FALSE" → display rivers

---

Scene stuff, aka the main character energy block 👑:

• --scene.center.gridpoint — type "INTEGER", default -1 → rank of the grid point to set focus on
• --scene.center.on — type "BOOLEAN", default "FALSE" → center 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" → display the date
• --scene.image.align — type "STRING", default "" → image alignment
• --scene.image.on — type "BOOLEAN", default "FALSE" → enable image display
• --scene.image.path — type "PATH", default "" → path to 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" → enable interpolation

---

Light settings, sunlight girlies rise ☀️:

• --scene.light.date — type "DATE", default "0000/00/00_00:00:00" → date for sunlight position
• --scene.light.date_from_grib.on — type "BOOLEAN", default "FALSE" → calculate light position from 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
• --scene.light.on — type "BOOLEAN", default "FALSE" → enable light
• --scene.light.rotate.on — type "BOOLEAN", default "FALSE" → make sunlight move
• --scene.light.rotate.rate — type "FLOAT", default 1 → rate of rotation: angle/frame
• --scene.lon_at_hour — type "FLOAT", default -1 → set longitude at solar time

---

Spin the globe 🌍✨:

• --scene.rotate_earth.on — type "BOOLEAN", default "FALSE" → make the earth rotate
• --scene.rotate_earth.rate — type "FLOAT", default 1 → rate of rotation: angle/frame

---

Picking and text, last stretch of this batch 🫶:

• --scene.select.field_rank — type "INTEGER", default 0 → rank of field to select
• --scene.text.a — type "STRING-LIST", default "" → 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" → foreground color
• …and the very last line of that font block that got split across the page break: Foreground color 🎀 (you know the drill by now, bestie — it's the color the text itself is painted in).

---

• --scene.text.on — Type: BOOLEAN, default: FALSE. Turns text on ✨
• --scene.text.s — Type: STRING-LIST, default: "". The actual strings you want on screen 🫶
• --scene.text.x — Type: FLOAT-LIST, default: "". Coordinates of strings 📍
• --scene.text.y — Type: FLOAT-LIST, default: "". Coordinates of strings 📍

---

• --scene.title.a — Type: STRING, default: "NW". Alignment 👑
• --scene.title.font.bitmap.path — Type: PATH, default: "fonts/08.bmp". Bitmap path 🖼️
• --scene.title.font.bitmap.scale — Type: FLOAT, default: 0.05. Bitmap scale 🔍
• --scene.title.font.color.background — Type: COLOR, default: "#00000000". Background color 🎨
• --scene.title.font.color.foreground — Type: COLOR, default: "#ffffffff". Foreground color 🎨
• --scene.title.on — Type: BOOLEAN, default: "FALSE". Turns the title on 💖
• --scene.title.text — Type: STRING, default: "". The title itself ✍️
• --scene.title.x — Type: FLOAT, default: 0. Coordinates 📍
• --scene.title.y — Type: FLOAT, default: 1. Coordinates 📍

---

• --scene.travelling.frames — Type: INTEGER, default: 100. Number of frames 🎞️
• --scene.travelling.on — Type: BOOLEAN, default: "FALSE". Turns travelling on 🚀
• --scene.travelling.pos1.fov — Type: FLOAT, default: 0. Field of view 👁️
• --scene.travelling.pos1.lat — Type: LATITUDE, default: 0. Latitude 🌍
• --scene.travelling.pos1.lon — Type: LONGITUDE, default: 0. Longitude 🌍
• --scene.travelling.pos2.fov — Type: FLOAT, default: 0. Field of view 👁️
• --scene.travelling.pos2.lat — Type: LATITUDE, default: 0. Latitude 🌍
• --scene.travelling.pos2.lon — Type: LONGITUDE, default: 0. Longitude 🌍

---

• --shell.on — Type: BOOLEAN, default: "FALSE". Runs the command line 💻
• --shell.prompt.on — Type: BOOLEAN, default: "FALSE". Starts an interactive session once the batch script finishes 🌀

---

• --ticks.E.dlat — Type: FLOAT, default: 10. Latitude interval 📏
• --ticks.E.dlon — Type: FLOAT, default: 10. Longitude interval 📏
• --ticks.E.nswe.on — Type: BOOLEAN, default: "FALSE". North/South/West/East labels instead of +/- 🧭
• --ticks.E.on — Type: BOOLEAN, default: "TRUE". Enables that side ✅
• --ticks.N.dlat — Type: FLOAT, default: 10. Latitude interval 📏
• --ticks.N.dlon — Type: FLOAT, default: 10. Longitude interval 📏
• --ticks.N.nswe.on — Type: BOOLEAN, default: "FALSE". North/South/West/East labels instead of +/- 🧭
• --ticks.N.on — Type: BOOLEAN, default: "TRUE". Enables that side ✅
• --ticks.S.dlat — Type: FLOAT, default: 10. Latitude interval 📏
• --ticks.S.dlon — Type: FLOAT, default: 10. Longitude interval 📏
• --ticks.S.nswe.on — Type: BOOLEAN, default: "FALSE". North/South/West/East labels instead of +/- 🧭
• --ticks.S.on — Type: BOOLEAN, default: "TRUE". Enables that side ✅
• --ticks.W.dlat — Type: FLOAT, default: 10. Latitude interval 📏
• --ticks.W.dlon — Type: FLOAT, default: 10. Longitude interval 📏
• --ticks.W.nswe.on — Type: BOOLEAN, default: "FALSE". North/South/West/East labels instead of +/- 🧭
• --ticks.W.on — Type: BOOLEAN, default: "TRUE". Enables that side ✅

---

• --ticks.frame.color — Type: COLOR, default: "#ff0000ff". Frame color 🖼️
• --ticks.frame.on — Type: BOOLEAN, default: "FALSE". Turns the frame on ✨
• --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 color 🎨
• --ticks.labels.font.color.foreground — Type: COLOR, default: "#ffffffff". Foreground color 🎨
• --ticks.labels.format — Type: STRING, default: "%+06.2f". The format used for tick labels 🔤
• --ticks.labels.on — Type: BOOLEAN, default: "FALSE". Displays tick labels 🔢
• --ticks.lines.color — Type: COLOR, default: "#ffffffff". Tick color 🎨
• --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". Displays ticks ✅
• --ticks.lines.width — Type: FLOAT, default: 0.01. Tick width 📐
• --ticks.visible.on — Type: BOOLEAN, default: "TRUE". Ticks are visible 👀

---

• --view.center.on — Type: BOOLEAN, default: "TRUE". Centers the view 🎯
• --view.clip.dlat — Type: FLOAT, default: 5. How much latitude gets clipped ✂️
• --view.clip.dlon — Type: FLOAT, default: 10. How much longitude gets clipped ✂️
• --view.clip.on — Type: BOOLEAN, default: "TRUE". Enables 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". Your choices: 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". Enables 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". Enables zoom with the Schmidt transform 🔍
• --view.zoom.stretch — Type: FLOAT, default: 0.5. Stretching factor 🫠

---

👀 SEE ALSO 👀

okay bestie, if you wanna go deeper (and you should, it's giving research era) 💅

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, the moment, the legend who built all of this ✨👑

---

and that's the whole page, bestie, we made it to the end 🎀 this lil manual is glgrib-glfw(1), dated 2026-07-03 — go forth and render some gorgeous planet vibes, no cap 💖🌍✨