BambooBasic

Version History, and general rambling! ;)

v1_2Lg (Thanks to Mike Hart for the bug hunting/suggestions in this version)

	- New: Git in the IDE (View > Git). A Git window to commit, pull and push, with a list of
	  what changed and tick boxes for what goes in; change marks beside your code (green new,
	  blue changed, red deleted) that update as you type, with a click to see or put back the
	  old lines; compare a file with its last commit side by side; the history of a project
	  or a file (open, compare or undo any commit); branches (switch, new, merge, delete, put
	  changes aside); and help sorting out merge clashes (keep yours, theirs or both). It
	  works on one Git project at a time - a repository, or one folder inside it - so other
	  files you have open never get committed by accident. It uses your own git (sudo apt
	  install git) with your usual settings and logins; to push to GitHub, set up a login Git
	  can use by itself first (gh auth setup-git, a credential helper, or SSH). See "Git" in
	  the docs.
	- New: Build > Command Line... - the arguments your program gets when you run it from the
	  IDE (Build and Run, Safe Build and Run, debugging), for testing sysArg, sysArgCount and
	  sysCommandLine. Kept for each program. On the web targets they go in the page address
	  (MyGame.html?level=3&mute), which is where a web program reads them.
	- New: Target > USB (ISO). Build makes a bootable ISO of your game: write it to a USB
	  stick and a PC starts straight into the game, with no system to install, and powers off
	  when you quit. Build and Run tries it in QEMU. See "USB Target" in the docs.
	- New: Edit > IDE Options > Remember the IDE's size and position. Off unless you turn it on. If
	  the saved place is on a screen that's no longer connected, the IDE opens centred instead.
	  On Linux under Wayland only the size comes back, as the desktop decides where windows go.
	- New: Twaddle > Copy System Info. Copies your IDE version, system, desktop, graphics card and
	  screens to the clipboard, ready to paste into a bug report.
	- New: tilemaps, the tm commands, on desktop and both web targets. Build a map in code or
	  load one exported from Tiled (.tmj), draw it in layers with parallax, animated tiles,
	  flips and zoom, and change it while playing. Only the tiles on screen cost anything.
	  Collisions are questions your game asks: tmBoxHit, tmRayCast, and pixel shapes on tiles
	  with tmGroundProbe for slopes and loops. tmSetTileAuto paints and digs terrain and sorts
	  out the edges. Isometric, staggered and hexagonal maps work too, and tmDrawLayerRow puts
	  sprites in among the tiles, so a character can walk behind a wall. Seven examples in
	  "37 - Tilemaps". See "Tilemaps" in the docs.
	- New: Case 6, 7 (a list of values) and Select on a String now compile.
	- New JSON functions: jsonBeginObjectField starts an object as a field's value
	  ("address": {...}), and jsonAddString, jsonAddInt and jsonAddDouble add values with no key
	  to an array ("hobbies": ["Reading", "Cycling"]). Neither could be written before.
	  Thanks to Mike for spotting it.
	- New JSON functions for reading objects back: jsonReadObject gives a field's object as
	  JSON text, to read with jsonReadString, jsonReadInt and the rest, and jsonGetObjectCount and
	  jsonGetObjectKey go through its fields when you don't know their names. A key of "" means
	  the text itself, so they work on the top level, or on an object from jsonGetArrayElement.
	  Desktop and both web targets. Thanks to Mike.
	- Fixed: reading a JSON field gave 0 or "" when its name appeared earlier as a value
	  (in {"type":"name","name":"Bob"}, jsonReadString(j, "name") was "").
	- New: the JSON functions on both web targets. All 21 are there, writing and reading, and
	  they give the same text as desktop, character for character. Three examples in
	  examples/Web/10 - JSON.
	- New: GLSL versions of five more example shaders in "14 - Shaders": AnimImageGlow,
	  AnimImageSimple, PulseImage, TextGlow and TextSheen. AnimImageGlow's parameters 4 and 5
	  take the frame size, so the edge glow follows each frame, not the whole sprite sheet.
	  Two new examples there use all five: AnimImageShader (keys 1/2/3 switch between
	  AnimImageSimple, AnimImageGlow and PulseImage) and TextShaders (TextGlow, with a
	  TextSheen title).
	- Fixed: a string with the word New in it, such as "New York", stopped the build with
	  "Type mismatch" when the result was put in a variable:
	  json = jsonWriteString(json, "city", "New York")
	- Fixed: scripts/install-desktop.sh hid other programs' icons, such as the weather app's.
	  It wrote its own ~/.local/share/icons/hicolor/index.theme, which took the place of the
	  system's. It doesn't write that file now, and running it again (or with --uninstall)
	  removes the one it wrote before. Log out and back in afterwards. Thanks to KURON.
	- Fixed: joining a number to a string with & gave junk (or blanks) when the number was an
	  array element (s = "n=" & arr[1]), a field ("hp=" & o\hp) or came first (a & " x").
	  Print was fine; assignments, Locals, Returns and a function's arguments weren't. On the
	  web, a & b & " x" added the numbers first. An element of a Global array ("g=" & garr[2])
	  didn't compile at all. Desktop and both web targets.
	- Fixed: Go to Definition (right-click) said "not found" for a Function or Method with a
	  return type (Function Make:String(...)), for anything in an Include in another folder
	  (Include "lib/wsg.bam", "../shared/util.bam"), and for anything in an Include's own
	  Includes. It now finds all three, and opens the file at the definition. Thanks to Mike Hart.
	- Changed: Go to Definition is now Ctrl+F12. F12 was also Debug > Continue, so it only ever
	  said "Not currently debugging." F12 is still Continue. (Mike)
	- Fixed: 44 help pages were missing from the Linux docs, so a second F1 found nothing:
	  fileFileDate, fileFileTime, fileFileStamp and sysLocalDate (Mike), the web file functions
	  (fileExportWeb, fileImportWeb, ...), and the keywords Data, Read, Restore, ReDim, EraseDim,
	  ArrayLength, Element and the Seq... sequence commands. A second F1 now also finds a keyword's
	  page however it's written (redim, DATA).
	- New: Data, Read and Restore, the classic BASIC way to keep tables of values in a program.
	  Data 3, "Forest", 1.5 holds numbers and strings, Read takes the next ones into variables
	  (converted to each variable's type), and Restore goes back to the start, or to a label:
	  .level2 on its own line marks a place, and Restore level2 reads from there. Works on
	  desktop and both web targets. Example in "24 - Data", and "Data, Read and Restore" in the
	  docs. A variable called data, read or restore still works. (KURON, forum #92)
	- New: an Include that isn't beside your program is looked for in BambooBasic's new
	  includes folder, which holds BBR_INCLUDE.bam - so Include "BBR_INCLUDE.bam" works from
	  any folder, with no copy. The IDE's autocomplete looks there too. (Mike, #91)
	- New: b2dDrawImage9Slice draws an image as a box of any size, keeping its corners their
	  own size: for panels, buttons and windows. Example in "39 - Nine Slice". (Mike, #89)
	- New: b2dCreateSubImage and b2dCreateAnimSubImage cut images out of a sprite sheet without
	  copying anything. Sprites from one sheet share draw calls: 200 of them are 9 draw calls.
	  Example in "40 - Sprite Sheets". Both new functions are on the web targets too. (Mike, #90)
	- New: Build > Clean Build Files... deletes the C++, object and list files a build leaves
	  beside the program, keeping the .bam files, the program and Media. (Mike, #85)
	- New: File > Open and Save As start in the folder you last used. Edit > IDE Options can
	  turn it off. (Mike, #86)
	- New: Twaddle > Copy Bug Report Form: your system's details and the forum's
	  bug report headings, ready to paste into a new thread. (Mike, #87)
	- Changed: the IDE's settings, recent files and open files are now kept in
	  ~/.config/BambooBasic, so a new version of BambooBasic starts with them. (Mike, #88)
	- Fixed: Quick Build failed after building one of the program's Includes on its own. It now
	  sees the generated files were changed and transpiles again. (Mike, #81)
	- Fixed: a locked build file wasn't locked again when the IDE was restarted. (Mike, #82)
	- Fixed: the Contents list was empty after a restart until you changed tab. (Mike, #84)
	- Fixed: Panda wouldn't start after scripts/deps-appdev.sh on Ubuntu, Mint and Debian
	  ("libwx_gtk3u_gl-3.2.so.0: cannot open shared object file"). The script now installs
	  libwxgtk-gl3.2-1t64 (wxGTK-gl on Fedora). On a machine that already ran it:
	  sudo apt install libwxgtk-gl3.2-1t64  (Mike)
	- Fixed: "Remember the IDE's size and position" was on in a fresh download, because the
	  download held our own editor.conf. It doesn't now. (Mike, #80)
	- Fixed: every BGI menu item showed an empty check box. Only a checked item shows a tick
	  now, as on Windows. (Mike, forum #65)
	- Fixed (web): b2dDrawAnimImage on a plain image drew nothing; b2dCopyImage shared the
	  original's texture, so freeing one broke the other; b2dFreeMovie kept the movie's
	  texture. (From Chris)
	- Fixed: some buttons cut off their text with large text turned on in the desktop settings.
	- Fixed: colours now mix as they do on Windows and the web. Anything drawn see-through
	  (b2dSetAlpha, a layer's alpha, soft image edges) came out brighter on Linux, a 50% red
	  over dark blue giving 162 where Windows gives 126, and b2dSetColor tints were a little
	  off too. Solid colours were already right and still are. If you wrote a custom shader
	  on Linux, it now gets the same colour values as on Windows.
	- Fixed: s = "a" & x + 1 didn't compile (on the web it gave "a31"), and s = "a" & -x gave
	  garbage. The sum is now worked out first, then joined, the same as in a Print.
	- Fixed: a pale line round the outline of an image drawn scaled, when its transparent pixels
	  hold a colour such as white (Inkscape saves them that way). No need to export it again.
	- Fixed: Print a && b now works. "text" && x is now an error that says to use a single &:
	  && means And, so the text was lost.
	- New: conditional compiling, so one program can build for several targets. #If, #ElseIf,
	  #Else and #EndIf, with Not, And, Or and brackets, and #Define for names of your own.
	  Each target sets its names: DESKTOP_DEB on Debian and Ubuntu, DESKTOP_ARC on Arch
	  (DESKTOP_WIN on Windows, and DESKTOP for all three), WEB_GPU, WEB_GL2 (and WEB for
	  both) and TARGET_USB. Code that's left out is never read, so it can hold another
	  target's Import, Include or commands. #If False switches a block off. The editor greys
	  out what the selected target leaves out. See "Conditional Compiling" in the docs, and
	  the example in "23 - Conditional Compiling".
	- New: ReDim, EraseDim and ArrayLength, for arrays whose size changes while the program
	  runs. ReDim map[w][h] gives new sizes and keeps what fits; EraseDim map[w][h] gives new
	  sizes and clears it; EraseDim map on its own clears it and keeps its sizes.
	  ArrayLength(map, 0) and ArrayLength(map, 1) give the sizes, and -1 for a dimension the
	  array doesn't have. They work on Local and Global arrays, on every target. See
	  "Resizing Arrays" in the docs and ReDim.bam in the Arrays examples.
	- A function can return an array sized while the program runs, into an array sized with
	  other names: Local level:Int[w][h] = CreateGrid(w, h), where CreateGrid has
	  Local grid:Int[cols][rows]. This was refused before, unless both used the same numbers.
	  The copy takes what both arrays have. On the web, returning a 2D or 3D array from a
	  function didn't work at all, and now does.
	- Fixed: a 2D or 3D Local array declared inside a loop or an If block didn't compile.
	  Such arrays are now freed when their block ends, each time round a loop and on Exit,
	  Continue and Return. A function with no Return used to keep its 2D and 3D arrays
	  forever; they're freed too now.
	- Fixed: Safe Build failed on a Global array used from another file or from a small
	  function ("..._size_0 was not declared").
	- New: Edit > Go to Line... (Ctrl+G). The line you go to is put in the middle of the editor.
	- New: View > Sort Contents A-Z puts the toolbar's Contents list in name order. Picking an
	  entry there now puts it in the middle of the editor, and an entry on the very first
	  line works (it did nothing before).
	- Typing a closing ", ) or ] when the editor has already put one after the cursor now
	  steps over it, so typing "x" gives "x", not "x"". A quote typed in front of a string
	  still starts a new one.
	- Fixed: typing a word and then a space while the autocomplete list was showing took the
	  word but lost the space.
	- Fixed: File > Open opened a second tab for a file that was already open. It now
	  switches to that file's tab.
	- Fixed: the Output tab's X did nothing (only File > Close closed it). It now closes the
	  tab, and the next build opens it again.
	- Fixed: the IDE could pause after typing in a long Git-tracked file with many changes,
	  as the change marks were redrawn.
	- Fixed: in the GUI designer, a Menu's items didn't get their OnClick functions written
	  into the program when the design was saved. They do now, sub-menu items included.
	- New: fileFileDate, fileFileTime and fileFileStamp, for when a file was last written.
	  The date and time come in the same form as sysCurrentDate and sysCurrentTime ("04 Nov
	  2026", "18:30:20"). The stamp is seconds since 1970, for comparing which file is
	  newer. On the web, the time is recorded whenever a file is written, so a file saved
	  before this version has none until it's saved again.
	- Fixed: fileCopyFile gave the copy the time it was made. It now keeps the original's
	  time, as on Windows.
	- New: sysLocalDate, today's date in the player's own style, from their language
	  settings or browser: 11/05/2026 in the US, 05/11/2026 in the UK. It's for showing on
	  screen; it differs from player to player, so use sysCurrentDate for anything saved.
	- Fixed: on the web, sysCurrentDate gave 04/11/2026 instead of 04 Nov 2026 as on desktop.
	  It's now the same everywhere.
	- Fixed: sysSetWindowTitle didn't change the window's title; it always said BambooBasic.
	  It works now, before or after b2dGraphics.
	- Fixed: the mouse trailed behind the pointer, by about a frame more than on Windows. With
	  vsync, b2dCls waited for the screen after sysUpdateEvents had read the mouse, so
	  everything was drawn where the mouse had been. sysUpdateEvents now does that wait
	  before it reads the mouse and keys, as Windows does.
	- Fixed: a program that never asked sysQuitRequested - every BGI and IGI program, and most
	  games - couldn't be stopped with kill, Ctrl+C in a terminal, or by the desktop when you
	  log out; only kill -9 worked. Now it stops at once. A program that does ask
	  sysQuitRequested still gets the chance to close itself, and a second Ctrl+C or kill
	  stops it if it doesn't.
	- Fixed: with vsync on, a program whose window was hidden behind other windows ran at 1
	  frame a second (seen with NVIDIA on GNOME Wayland), and so did its timers, music and
	  input, and quitting was slow. Now it carries on at the screen's rate while hidden, and
	  draws normally again as soon as it shows.
	- Changed: Vulkan's validation layer (its checks for graphics mistakes) is only on when you
	  ask for it. Before, it was on in every program on a machine that had it installed,
	  which made programs slower there (about a quarter, in one test). Safe Build and Run and
	  Start Debugging turn it on, so its warnings still show in the output; Build and Run and
	  your finished game go without. To turn it on yourself: BB_VULKAN_VALIDATION=1 ./MyGame
	- Fixed: the Debug View tab couldn't be closed with its X (as the Output tab couldn't), and
	  closing it with Ctrl+W could crash the next debug run. Both close it now. While a program
	  is running from Safe Build and Run or Start Debugging it stays open: stop the program first.
	- Fixed: audMusicPlaying gave 0 after audStopMusic and a second
	  audPlayMusic. The desktop music functions wanted the number audPlayMusic returned, the
	  web ones the audLoadMusic handle, and the handle only worked on desktop by luck the first
	  time. Now audStopMusic, audPauseMusic, audResumeMusic, audSetMusicVolume, audSetMusicPan
	  and audMusicPlaying take the audLoadMusic handle on every target, and act on that music's
	  latest play. The channel audPlayMusic returns still works too.
	- audPlayMusic on desktop now returns a channel, like audPlaySound, so the channel
	  functions work with it too. Playing music that's already playing restarts it.
	- On desktop, audChannelPlaying and audMusicPlaying give 0 while paused, as on the web.
	- Web: b2dLoadTTF fonts are now the same size as on desktop (they were about 12% bigger).
	- Web: keys now reach a game shown inside another site (such as itch.io) after a click, and
	  MouseX / MouseY are right when the page shows the game bigger or smaller.
	- New: Undo and Redo (Ctrl+Z / Ctrl+Y) in the GUI Designer. Every change to the design can
	  be taken back - deleting a menu with all its items, moving, adding, and any property.
	- New: in the GUI Designer, drag the squares on a selected control's corners to resize it.
	- New: Build > Build For Itch (Web). With a web target chosen, it builds the game and makes
	  ItchOutput/<YourGame>-itch.zip, ready to upload to itch.io as a browser game: a plain page
	  that scales the game to fit (and works with itch's fullscreen button), and checks for file
	  names whose upper/lower case won't match on itch.io. See "Publishing on itch.io" in the
	  web docs.
	- New: Panda, a 3D modeller (Tools > Panda Modeller...). Make models from boxes, spheres,
	  cylinders or your own vertices and faces, colour and texture them, animate them with pose
	  frames or a skeleton, and save them as .bb3d, .glb or BambooBasic code. Its full manual is
	  in Panda's Help menu (F1). Example: examples/Runtime/38 - Panda.
	- Changed: the GLB to .bb3d Mesh Converter now keeps a model facing the right way (before,
	  converted models showed their backs, mirrored). The Wibble example mesh is converted to match.

v1_2Lf

	- Linux builds web games now. The Target menu has Web (WebGL2) and Web (WebGPU) beside
	  Desktop: the same program runs in a browser, built to JavaScript. Web (WebGL2) runs in
	  practically every browser, Linux ones included; Web (WebGPU) needs a browser with
	  WebGPU switched on (on Linux, Chrome or Chromium started with --enable-unsafe-webgpu
	  --enable-features=Vulkan). Import BBRuntimeWebGL2.decls or BBRuntimeWeb.decls, put the
	  loop in Function WebLoop(), and Build and Run: the editor serves the page from
	  WebOutput on http://127.0.0.1:8000 and opens it in your browser (Build > Stop stops the
	  server). Upload WebOutput to any web host to publish it. See "Building for the Web" in
	  the docs, and examples/Web for a set of programs in both forms (_wgl and _web).
	- Building a program for the wrong target (a web one with Desktop selected, or the other
	  way round) asks whether to switch the Target menu first. File > New > BGI Application
	  asks Desktop or Web.
	- Big programs can be split over Include files properly now. Each .bam becomes its own C++
	  file, compiled on its own, so editing one file recompiles only that file (with Quick
	  Build on), several at once, and changing a global, constant, function header or Type
	  rebuilds the lot. Files can call back into the main file, the same file can be
	  included from two places, includes inside subfolders work, and Functions can have
	  default parameter values: Function Clamp:Int(v:Int, lo:Int = 0, hi:Int = 100) can be
	  called as Clamp(150). See examples/Language/22 - Multi-file.
	- Transpiling is much faster on big programs (a 10,000-line game went from 26 s to under
	  a second), and programs that don't use AutoCall run their loops up to 28 times faster.
	- New: a built-in profiler. b2dShowProfiler(True) shows a panel with FPS, frame times and
	  a graph of them, the CPU and GPU time a frame took, the draw calls, and your own
	  sections (sysProfileStart / sysProfileEnd). Also readable in code: b2dGetFrameTime,
	  b2dGetGPUTime, b2dGetDrawCalls, sysProfileTime. See examples/Runtime/36 - Profiler.
	- New: b2dSetImagePixels fills a whole image from an Int array ($AARRGGBB per pixel) in
	  one call, and b2dSetImageSmooth(image, False) keeps an image's pixels sharp when it's
	  drawn scaled.
	- New: fileReadBytes / fileWriteBytes move a block of bytes between a file and a Byte
	  array in one call.
	- New: sound streams for sound your program makes as it runs - audCreateStream,
	  audQueueStream (16-bit samples from a Short array), audStreamQueued, audFreeStream.
	  When you fall behind it plays silence rather than stopping.
	- New: audSetReverb(preset, volume) puts the PlayStation's reverb presets (room, studio,
	  hall, echoes, delay) on the sound effects played from then on. See
	  examples/Runtime/9 - Audio/Reverb.bam.
	- New: sysArgCount(), sysArg(i) and sysCommandLine() read the command line a program
	  was started with.
	- New: b2dNoRuntimeSplash(), which turns off the Windows edition's splash screen. It
	  does nothing here (there isn't one), so the same program builds on both.
	- New operator ShrU, a shift right that fills with zeros: -1 ShrU 28 is 15, where
	  -1 Shr 28 stays -1.
	- Byte (0 to 255) and Short (-32768 to 32767) are documented and highlighted, and
	  b = b + 1 into one works; Print of a Byte shows the number, not a character. A global
	  Byte array no longer needs anything extra to compile with GCC 13 and later.
	- + joins strings now whenever either side is a string, left to right: "Score: " + score
	  works ("a" + 1 + 2 is "a12", 1 + 2 + "a" is "3a").
	- Fixed: s = s & strMid(t, i, 2) not compiling; b = Asc(t) not going into an Int, and Asc
	  giving negative numbers above 127; Return a[x] = 0 (and If .. Then Return a = b)
	  assigning instead of comparing; flag = b = 7 changing b; Show(m = 2) setting m; Print
	  m = 2 and Print m <> 2; Print a Shr 1 not compiling; 2.0e-11 and other scientific
	  notation not compiling; "a" & ToInt(x) adding a character; Show(strMid(t, i + 1, 1))
	  being called an int; $80000000 to $FFFFFFFF not being negative; a global array passed
	  to an array parameter; a field or method straight off a call's result (Best()\name).
	- Building a program meant for another target (one that imports a web or PlayStation
	  runtime) now stops with a message saying so.

v1_2Le

	- Added IGI, the Immediate Gizmo Interface, to Linux: the in-game GUI built on Dear ImGui
	  that the Windows and web editions got in 1.2e. Menus, HUDs, debug panels and editors drawn
	  over your game - call the igi functions every frame between drawing and b2dFlip (values go
	  in, new values come out: volume = igiSliderInt("Volume", volume, 0, 100)). All 90 igi
	  functions, the same as Windows: windows, buttons, sliders, text boxes, drop-downs, lists,
	  trees, tabs, menus, pop-ups, images, themes, every ImGui colour, roundings, sizes and your
	  own fonts. It looks the same as on Windows - same font, same colours, same blending - and
	  it is drawn after any screen shader, so a CRT effect bends the game but not the HUD.
	  See examples/Runtime/35 - IGI.
	- IGI's code editor works too: syntax colouring, line numbers, undo, marked lines with
	  tooltips, and copy and paste with the system clipboard. Languages are .lang files;
	  BambooBasic, C++, Lua, WGSL and HLSL come in userlibs/languages. IGI's fonts are built
	  into the runtime, so a program needs nothing extra beside it.
	- Fixed ToDouble / ToInt of a String array element (ToDouble(words[1])) not compiling, in
	  a Print as well as anywhere else.
	- Designer fixes: text with quotes or < > & in it saves and loads properly, nested submenus
	  survive being reopened, the generated onSelect handlers no longer call a missing Str(),
	  and the event dispatcher is kept up to date however your loop is indented.
	- BBR_INCLUDE.bam has the IGI constants (IGI_WINDOW_*, IGI_COL_*, IGI_STYLE_*) and is the
	  same file as the Windows edition's again.

v1_2Ld

	- MOVIES ARE IN LINUX BABY, and they are real video files now. b2dLoadMovie takes an .mp4, .mkv,
	  .webm and so on directly - the old .bbv format and its converter are gone. Same 16
	  calls as before (play, pause, resume, stop, loop, volume, draw, draw scaled), and the
	  picture keeps time with a real clock, so a slow frame skips rather than slowing the
	  film down. The soundtrack plays through the same audio engine as everything else.
	  On Linux the decoding is done by GStreamer, which comes with most desktops. If a movie
	  will not load, run scripts/deps-runtime.sh - it checks for the plugins that decode
	  video. Fedora and openSUSE users need RPM Fusion or Packman for most .mp4 files, as
	  they leave H.264 out of their official repositories.
	  See examples/Runtime/31 - Movies.
	- Added b2dLoadMesh(), which loads 3D models baked to .bb3d, animated ones included. The
	  runtime stores the model and blends its animation frames; your program turns and
	  projects the points and draws the faces, the 3D-in-2D way. b2dMeshAnimate will blend ANY
	  two frames, so if a model's animation clips are rubbish (some exporters make every clip
	  the whole animation) you can still loop just the frames you want. Models with no texture
	  carry their own face colours - b2dMeshFaceR/G/B. See examples/Runtime/30 - Meshes, and
	  docs/3d_in_2d.html.
	- Added b2dFreeMesh(), to free a loaded mesh (and its texture) when you're done with it.
	- b2dLoadMesh also rejects a .bb3d whose faces point at vertices that don't exist.
	- Mesh examples no longer draw the model tinted by the help text colour.
	- The IDE starts on glibc 2.38 again (Ubuntu 24.04, Debian 13). One maths call in the GLB
	  converter had quietly raised it to 2.43.
	- Added Tools -> GLB to .bb3d Mesh Converter to the IDE, to make those models. Point it at a
	  .glb, pick a folder and a name, and it writes the .bb3d plus the texture as a .png. Skeletal
	  animation is baked to frames at the rate you choose. Afterwards it offers a preview you can
	  scrub through frame by frame, which is the way to find out which frame numbers are which
	  movement when a model's clips are no help.
	- Added the AI Assistant (View -> AI Assistant, Ctrl+Shift+A): a chat window where Claude
	  answers questions about BambooBasic, explains your code, fixes build errors and, if you
	  let it, edits the files you attach. It looks things up in the docs and examples rather
	  than guessing. You need your own Anthropic API key, which is kept in your desktop's
	  keyring. Right-click in the editor and pick Ask AI about this to ask about a selection.
	  See docs/ai_assistant.html.
	- Added b2dDrawImageQuad(), which stretches an image over any four corners, and
	  b2dDrawImageQuadDepth(), the same with a depth per corner so textured faces hide each
	  other properly without sorting. The UV versions, b2dDrawImageQuadUV and
	  b2dDrawImageQuadDepthUV, let each corner show a chosen part of the image - atlases, or
	  a model's own texture mapping. See examples/Runtime/29 - Image Quads.
	- Debug builds of big programs compile MUCH faster. The debugger used to send every
	  global and constant after every single line, which made the generated code enormous
	  (27 MB for Anti-Tetrafied); it now sends them only when you are actually paused, which
	  took that down to 556 KB. As a bonus, globals now show in the variables panel while you
	  are paused inside a function too, not just in Main.
	- Fixed building a string with & that includes a function returning a number, like
	  s = "Score: " & GetScore(). It would not compile unless you Printed it directly. Same
	  for a plain number (s = "Lives: " & 3).
	- Fixed & inside a call's brackets in a Print - Print Shout("Hi " & name) turned the &
	  into a bitwise OR and did not compile. Print "x" & Chr(65) and Asc() work too now, and
	  so does joining two plain strings, s = "a" & "b".
	- A right-click in the editor now moves the cursor to where you clicked, so Go to
	  Definition works on the word you clicked rather than wherever the cursor was.
	- Fixed declarations with a * (pointer) parameter - they were quietly turned into a
	  broken "void" and failed to compile. b2dMeshCopyVertsX/Y/Z need it, to fill a whole
	  array in one call.
	- Dependency scripts know about GStreamer, and the docs cover all of the above: 404 of
	  404 functions documented.

v1_2Lc

	- THE BIG ONE: the 3D engine is gone, and everything that survived it is now b2d*.
	  b3dGraphics3D -> b2dGraphics, b3dCls3D -> b2dCls, b3dFlip3D -> b2dFlip,
	  b3dEnd -> b2dEnd, and the whole screen shader family (b3dLoadScreenShader,
	  b3dApplyScreenShader, b3dSetShaderFloat and friends) are b2d* too. Existing
	  programs need renaming - it is names only, the behaviour is unchanged.
	- Added b2dDrawQuad(), a four-cornered polygon given as four screen points, filled
	  or outlined. b2dDrawRect can only do axis-aligned boxes; this does the wonky ones,
	  which is what a projected 3D face or a pseudo-3D road actually is. No backface
	  culling - both windings draw, deliberately.
	- Added b2dSetDepth() and a real depth buffer, so 2D PRIMITIVES can be depth-tested
	  and drawn in any order. Images and text are never depth-tested, so a HUD still sits
	  on top the way it always did, and code that never calls it behaves exactly as before.
	- Added b2dDrawQuadDepth(), the same quad but with a depth per CORNER, interpolated
	  across the face. That is what lets two faces of the same solid intersect properly
	  instead of one popping through the other. One gotcha and it is yours, not the
	  runtime's: feed it PROJECTIVE depths of the form a + b/z, not raw view-Z, or a flat
	  face creases along its diagonal. See docs/3d_in_2d.html.
	- Added b2dSetClipRect() / b2dClearClipRect() - a 2D scissor. Affects primitives,
	  images AND text, applies only to draws made after the call, and is cleared at the
	  start of each frame so a forgotten one cannot leak into the next.
	- Added b2dGetFPS(), which the Windows side already had.
	- 2D images now get a full mipmap chain, so sprites stop shimmering when drawn small.
	  No API change. Sprite sheets and font atlases deliberately do NOT get one - a mip
	  level would average across the boundaries between frames or glyphs and bleed the
	  neighbours in.
	- Added b2dLoadTTF(), which loads a TrueType/OpenType font (.ttf/.otf) at a pixel size
	  you choose and hands back an ORDINARY font handle. b2dDrawText, b2dDrawTextEx,
	  b2dGetStringWidth/Height, b2dGetFontWidth/Height and b2dFreeFont all take it, so the
	  only line that changes in your program is the one that loads the font. Glyphs are
	  rasterised from the outlines on first use and cached, and text is now decoded as
	  UTF-8, so you get whatever the font actually contains rather than the 256 characters
	  a bitmap font can hold - accents, Greek, Chinese. b2dLoadFont and the bitmap path are
	  untouched, and existing programs render identically.
	  Two things that are deliberate rather than oversights: each size is its OWN
	  b2dLoadTTF call, because stretching one set of glyphs to another size is exactly what
	  makes text look mushy; and the glyph cache has a ceiling, so a program putting many
	  thousands of DIFFERENT characters on screen at once will eventually stop caching new
	  ones and leave gaps rather than slow down. Neither bites normal use.
	  See examples/Runtime/28 - TTF Fonts - TTFTest.bam to look at it, TTFCheck.bam to
	  check it (it prints the measurements and saves the frame it drew).
	- Fixed a nasty one in the mouse: the reported cursor position had become dead-reckoned
	  from movement events, so anything that happened while the pointer was off the window
	  was lost for good, and the clamp turned it into a ratchet - every trip off the window
	  left the position permanently further adrift. Symptom was menu buttons lighting up
	  while the cursor was somewhere else entirely. It now reads the real pointer unless
	  the program is driving the cursor itself (mouse-look), which is the only case that
	  needs dead reckoning.
	- Fixed mouse coordinates under fullscreen letterboxing - they were being handed over in
	  surface pixels as though they were your coordinate space, with no fit applied.
	  inpGetMouseX/Y and inpMoveMouse now both map through it.
	- Fixed sysUpdateEvents sampling the mouse BEFORE pumping the event queue, so every
	  reading was one pump out of date.
	- Fixed inpMoveMouse moving the OS pointer but not the reported cursor, so a program
	  that warped and read straight back got the old value for a frame.
	- Fixed the second-F1 detailed help lookup, which said "No documentation found" for most
	  of the runtime - it guessed the docs folder from the function name prefix and only
	  knew four of them. It now searches all the categories, so all 363 functions resolve.
	- Fixed folder links in the IDE's documentation (the Examples link on the index) doing
	  nothing on Linux - it shelled out to Windows Explorer. Now uses whatever file manager
	  the desktop provides.
	- Docs: pages for everything above, the 3D-in-2D guide, and the category indexes are
	  generated from what is on disk now, so they cannot drift. 363 of 363 documented.
	- make dist tidied up: no more stale manifests, no more files from the Windows share
	  arriving marked executable, and .linkflags is no longer shipped with this machine's
	  absolute paths baked into it.

v1_2L
	
	- Another one for the codgers amongst us; Palette Cycling & Indexed Colour functions (see docs)
	- Fixed a few editor loose ends
	- Fixed FileCopy bug that would always return 0, even if the file was copied successfully
	- Added "PreCalc" block, this runs at build time, inside the transpiler, and bakes its 
	  results into your program as an array literal. (See docs) 
	- Added "AutoCall", which calls a function once/every specified amount of milliseconds... Think
	  Amstrad CPC's software interrupt mechanism... Sorry, I had to do it! ;)
	- Added With...EndWith block, for adding data to type and element fields (syntax sugar really),
	  again, see docs.
	- Added string interpolation for string variables/objects fields e.g. 
		
		Local age:Int = 49
		Print "My age is {%age}"
		
		Output: My age is 49
		
	- Added "Sequence"'s, which are BambooBasic's version of proper list containers (See docs)
	- Added Elements, which can we used with Sequence lists (Like Types, but not, again, see docs) 
	- Hopefully fixed intergrated/discrete combo GPU device crashes (and stop Window
	  updates breaking settings), also, a fall back to WARP, so the app shouldnt die when opened
	  on less-spec'd machines, though, it will probably run like shit! :D

v1_1
	
	- Added "Experimental" web target
	- Fixed screen shader code as I had hardcoded values in them when testing with the CRT shader
	- Fixed mid-frame GPU buffer resizing when dynamically adding entities.
	- Transpiler fix, detects unclosed blocks (If, Select etc etc)
	- Fixed type iteration crash when removing objects from the internal list in a For Each loop
	- Fixed jsonGetArrayCount returning the wrong value.
	- Added b3dCenterMesh(), b3dOpenFileDialog(), b3dSaveFileDialog and b3dOpenFolderDialog.
	- Fixed b3dCountTriangles for GPU meshes
	- Fixed DXGI shutdown crash (Cheers Amon)
	- Fixed b3dLoadBRSFile() function in regards to rotation.

v1_0

	- Full release... To much to add since I added 3D (Windoews) stuff, but, this IS the baseline now!
