Skip to content
/ fblo Public

JayRM's FreeBASIC Load Out - Translated headers and prebuilt static libraries for FreeBASIC win32/win64 that can be can be dropped in to an existing standalone FreeBASIC install.

License

View license
2 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

jayrm/fblo

BranchesTags

Repository files navigation

JayRM's FreeBASIC Load Out - v0.4

Translated headers and prebuilt static libraries for FreeBASIC win32/win64 that can be can be dropped in to an existing standalone FreeBASIC install.

The Load Out is intended to provide users with source code and libraries that would be otherwise difficult to find or build on their own; collected in one package and ready for use.

The repository contains the scripts needed to build win32/win64 libraries from sources, translate C headers, copy licensing information and package in to a release distribution.

License

For binary releases, see ./doc/{package}-license.txt for license statement for each of the packages included with the release. Translated C header files may also contain the copyright statement or license information.

For the source repository itself, which currently only contains scripts for building, see ./LICENSE.txt in the top level directory.

Other sources included in the repository will have their own copyright statement or license information.

Packages Included in the Load Out

  • fblo: JayRM's FreeBASIC Load Out
  • fbfrog: A binding generator for FreeBASIC
  • FBImage: Load BMP, PNG, JPG, TGA, DDS from file or memory as FBImage
  • fbpng 3.2.z: FreeBASIC PNG Library
  • libogg 1.3.2 - Reference implementation of the Ogg media container
  • libvorbis 1.3.7 - Reference implementation of the Ogg Vorbis audio format
  • libmad-0.15.1b - MPEG audio decoder library
  • libdumb-0.9.3 - Dynamic Universal Music Bibliotheque
  • libcsidlight - SID Emulator for playing C64 SID streams
  • fbsound-1.2 - A free sound library for FreeBASIC compiler
  • libpng 1.6.40 - PNG Reference Library
  • pcre 8.45 - Perl-Compatible Regular Expression
  • pcre2 10.42 - Perl-Compatible Regular Expressions
  • zlib 1.3 - Data Compression Library

Installing a Prebuilt Load Out

  1. Download the release package that matches your version of freebasic.

    For example: for FreeBASIC 1.10.0 using winlibs gcc-9.3 toolchain: fblo-0.4-fbc-1.10.0-winlibs-gcc-9.3.0.7z

  2. Extract in to your FreeBASIC installation. careful! - some files may be replaced The top level directory was omitted on purpose, since users may have renamed fbc installation directory.

Details About the Packages

  • fblo: JayRM's FreeBASIC Load Out

    • Copyright (C) 2023 Jeff Marshall <coder[at]execulink.com>

    • Files for Load Out:

      • ./fblo-readme.txt
      • ./doc/fblo-license.txt

  • fbfrog: A binding generator for FreeBASIC

  • FBImage: Load BMP, PNG, JPG, TGA, DDS from file or memory as FBImage

    • subset of SOIL library assembled by D.J.Peters (Joshy) https://shiny3d.de/public/libs/FBImage.zip

    • stb_image_write - v1.02

    • Simple OpenGL Image Library

      • Jonathan Dummer 2007-07-26-10.36
      • public domain
      • using Sean Barret's stb_image as a base

    • simple DXT compression / decompression code

      • Jonathan Dummer - 2007-07-31-10.32
      • public domain

    • image helper functions

      • Jonathan Dummer
      • MIT license

    • Files for Load Out:

      • ./doc/FBImage-license.txt
      • ./inc/FBImage.bi
      • ./lib/win32/libFBImage-32-static.a
      • ./lib/win64/libFBImage-64-static.a

  • fbpng 3.2.z: FreeBASIC PNG Library

    • Copyright (C) 2007-2010 Simon Nash/Eric Cowles

    • Copyright (C) 2022 Ebben Feagan

    • https://github.com/mudhairless/fbpng/

    • Files for Load Out:

      • ./doc/fbpng-license.txt
      • ./inc/fbpng/fbmld.bi
      • ./inc/fbpng/fbpng.bi
      • ./inc/fbpng/fbpng_gfxlib2.bi
      • ./inc/fbpng/fbpng_opengl.bi
      • ./inc/fbpng/png_image.bi
      • ./inc/fbpng/png_pal_conv.bi
      • ./inc/fbpng/png_row_conv.bi
      • ./lib/win32/libfbpng.a
      • ./lib/win64/libfbpng.a

  • libogg 1.3.2 - Reference implementation of the Ogg media container

  • libvorbis 1.3.7 - Reference implementation of the Ogg Vorbis audio format

    • Copyright (c) 2002-2020 Xiph.org Foundation

    • https://github.com/xiph/vorbis/

    • https://xiph.org/vorbis/

    • Files for Load Out:

      • ./doc/libvorbis-license.txt
      • ./inc/vorbis/vorbis.bi
      • ./inc/vorbis/vorbisenc.bi
      • ./inc/vorbis/vorbisfile.bi
      • ./lib/win32/libvorbis.a
      • ./lib/win32/libvorbisenc.a
      • ./lib/win32/libvorbisfile.a
      • ./lib/win64/libvorbis.a
      • ./lib/win64/libvorbisenc.a
      • ./lib/win64/libvorbisfile.a

  • libmad-0.15.1b - MPEG audio decoder library

  • libdumb-0.9.3 - Dynamic Universal Music Bibliotheque

  • libcsidlight - SID Emulator for playing C64 SID streams

  • fbsound-1.2 - A free sound library for FreeBASIC compiler

    • Copyright 2005 - 2020 by D.J.Peters (Joshy)

    • https://www.freebasic.net/forum/viewtopic.php?t=28905

    • Forked version at https://github.com/jayrm/fbsound/

    • Files for Load Out:

      • ./doc/fbsound-license.txt
      • ./inc/fbsound/fbs-config.bi
      • ./inc/fbsound/fbs3d.bi
      • ./inc/fbsound/fbscpu.bi
      • ./inc/fbsound/fbsdsp.bi
      • ./inc/fbsound/fbsound.bi
      • ./inc/fbsound/fbsound_dynamic.bi
      • ./inc/fbsound/fbsound_oop.bi
      • ./inc/fbsound/fbstypes.bi
      • ./lib/win32/libfbscpu.a
      • ./lib/win32/libfbsdsp.a
      • ./lib/win32/libfbsound.a
      • ./lib/win64/libfbscpu.a
      • ./lib/win64/libfbsdsp.a
      • ./lib/win64/libfbsound.a
      • ./bin/win32/fbsound-32.dll
      • ./bin/win32/fbsound-ds-32.dll
      • ./bin/win32/fbsound-mm-32.dll
      • ./bin/win32/fbsound-64.dll
      • ./bin/win32/fbsound-ds-64.dll
      • ./bin/win32/fbsound-mm-64.dll

  • libpng 1.6.40 - PNG Reference Library

    • Copyright (c) 1995-2023 The PNG Reference Library Authors

    • http://www.libpng.org/

    • Files for Load Out:

      • ./doc/libgpng-license.txt
      • ./inc/png16.bi
      • ./lib/win32/libpng16.a
      • ./lib/win64/libpng16.a

  • pcre 8.45 - Perl-Compatible Regular Expressions

    • Written by Philip Hazel

    • Copyright (c) 1997-2021 University of Cambridge

    • https://https://www.pcre.org/

    • Files for Load Out:

      • ./doc/pcre-license.txt
      • ./inc/pcre.bi
      • ./inc/pcreposix.bi
      • ./lib/win32/libpcre.a
      • ./lib/win32/libpcre16.a
      • ./lib/win32/libpcre32.a
      • ./lib/win32/libpcreposix.a
      • ./lib/win64/libpcre.a
      • ./lib/win64/libpcre16.a
      • ./lib/win64/libpcre32.a
      • ./lib/win64/libpcreposix.a

  • pcre2 10.42 - Perl-Compatible Regular Expressions

    • Written by Philip Hazel Copyright (c) 1997-2022 University of Cambridge

    • Files for Load Out:

      • ./doc/pcre2-license.txt
      • ./inc/pcre2.bi
      • ./inc/pcre2posix.bi
      • ./lib/win32/libpcre2-8.a
      • ./lib/win32/libpcre2-16.a
      • ./lib/win32/libpcre2-32.a
      • ./lib/win32/libpcre2-posix.a
      • ./lib/win64/libpcre2-8.a
      • ./lib/win64/libpcre2-16.a
      • ./lib/win64/libpcre2-32.a
      • ./lib/win64/libpcre2-posix.a

  • zlib 1.3 - Data Compression Library

    • Copyright (C) 1995-2023 Jean-loup Gailly and Mark Adler

    • https://www.zlib.net/

    • Files for Load Out:

      • ./doc/zlib-license.txt
      • ./inc/zlib.bi
      • ./lib/win32/libz.a
      • ./lib/win64/libz.a

Building the Load Out from Scratch

The intent is that the scripts will download source files, compile them with a specified toolchain (or all of the toolchains), and package in to a distribution that can be extracted directly in to a pre-existing FreeBASIC installation directory.

Basic steps:

  1. mk-pkgs.bat (calls ./mk-pkg.sh, build.sh)
  2. mk-distros.bat (uses ./makefile)

The batch files and scripts require toolchains to be pre-installed at some known locations and (sorry) most paths are currently hard coded. (perhaps in a future version this can be easily configured).

  • Build environment (32-bit and 64-bit versions)

    • c:/msys32/mingw32, c:/msys32/usr/bin
    • c:/msys64/mingw64, c:/msys64/usr/bin
    • Base install plus 'make tar zip p7zip git wget curl unix2dos'

  • FreeBASIC (32-bit and 64-bit versions)

    • d:/fb.git/fbc-win32.exe
    • d:/fb.git/fbc-win64.exe
    • d:/fb.1.10/fbc-win32.exe
    • d:/fb.1.10/fbc-win64.exe
    • d:/fb.1.20/fbc-win32.exe
    • d:/fb.1.20/fbc-win64.exe

  • gnu gcc toolchains (32-bit and 64-bit versions)

    • c:/winlibs-9.3/mingw32 , c:/winlibs-9.3/mingw64
    • c:/mingw-w64-5.2/mingw32 , c:/mingw-w64-5.2/mingw64
    • c:/mingw-w64-11.2/mingw32 , c:/mingw-w64-11.2/mingw64

  • fbfrog (jayrm forked version):

    • d:/fbfrog.git/fbfrog.exe

Tools Used

- FreeBASIC     https://www.freebasic.net/
                https://github.com/freebasic/fbc/
- fbfrog        https://github.com/freebasic/fbfrog/
- fblo          https://github.com/jayrm/fblo/
- MSYS2         https://www.msys2.org/
- GCC           https://gcc.gnu.org/
- GNU binutils  https://gnu.org/software/binutils/
- MinGW         https://osdn.net/projects/mingw/
- MinGW-w64     https://mingw-w64.org/
                https://github.com/niXman/mingw-builds-binaries/
- WinLibs       https://www.winlibs.com/

TODO

  • add project name to license files (to make obvious besides filename)
  • move hard coded paths to a configuration
  • allow configuration to select fbc versions
  • allow configuration to select toolchains
  • review makefile process - maybe shell scripts would have been simpler since the extract/confgure/make/package is typically only completed once for each package, the makefile is overkill (though the makefile is nice to have for dealing with lots of variables, paths, and files)
  • reduce to single target build configuration - building for multiple toolchains and fbc versions is nice, but can probably do a single targeted goal once most of the bugs in scripts are worked out and we move on to a newer release of fbc
  • make a shell script for dealing with license file and fbfrog header seems like an opportunity to reduce copies of duplicated script
  • use the newly built fbfrog.exe instead relying on the host install
  • add a tests folder to do at least a rudimentary compile check of headers
  • add some non-trivial examples of library usage
  • decide about adding copies of the translater headers to the repo itself might be nice for sharing development fixes of translated headers, but without a matching static library, might also cause unexpected incompatibility
  • decide where user contributed code will live - i.e. useful headers and code to included in the load out but do not necessarily warrant an independant repo to pull from
  • decide where original sources will live. Maybe attached to the release? it doesn't seem right to commit source packages in to the repo
  • write an alternate set of instructions for using the load out but not installed in the freebasic installation directory. Users may want to try out the load out but not overwrite files in the installation.
  • write instructions for reporting bugs
  • write instructions for forking the load out to make contributions
  • ask for help with linux or other targets (I don't think I have enough gas in the tank for that trip).

Thanks for downloading!

Jeff Marshall <coder[at]execulink.com>

About

JayRM's FreeBASIC Load Out - Translated headers and prebuilt static libraries for FreeBASIC win32/win64 that can be can be dropped in to an existing standalone FreeBASIC install.

Topics

bindings headers prebuilt freebasic static-library

Resources

Readme

License

View license
Activity

Stars

2 stars

Watchers

2 watching

Forks

0 forks
Report repository

Releases 3

JayRM's FreeBASIC Load Out - v0.4 Latest
Nov 13, 2023
+ 2 releases

Packages

No packages published

Languages