Gamp v0.0.7-36-g24b1eb6
Gamp: Graphics, Audio, Multimedia and Processing
|
gamp /gămp/ noun
said to allude to Mrs. Gamp's umbrella, in Dickens's Martin Chuzzlewit.
if you carry an umbrella use it tightly rolled and never as a gamp — S. D. Barney
... further Gamp stands for Graphics, Audio, Multimedia and Processing, the same way as JogAmp, but natively plus using WebAssembly.
This project's canonical repositories is hosted on Gothel Software.
Gamp addresses hardware accelerated graphics, audio, multimedia and processing. It is implemented in C++, supports WebAssembly and perhaps interfacing w/ other languages/systems.
Gamp replicates JogAmp's experience natively via C++ in a condensed form, allowing a similar workflow on native targets and within the browser via WebAssembly.
Ironically this will bring back runs everywhere including the web.
Initial goal is to reimplement Graph/GraphUI utilizing Rami Santina's Resolution independent NURBS curves rendering using programmable graphics pipeline 2011 (paper slides).
Gamp uses jaulib for general purpose functionality including linear algebra and geometry.
gfxbox2 of our CS class evaluated the C++ to WebAssembly path earlier.
This project is currently very much unstable and heavily WIP.
All APIs, if any, will change - but I thought it is nice to share the development with whoever might be interested.
Surface
and Window
OpenGL
abstraction w/ GLProfile
and GL
context (bound to Surface
)RenderListener
covers GLEventListener
semanticsSDL2
based mainloop implementation for the aboveOpenGL
attribute array data objects for client and VBO server objects + interleaved sub-arraysGLArrayData
, ... GLArrayDataServer<T>
OpenGL
uniform data objectsGLUniformData
, ... GLUniformSyncMatrices4f
ShaderCode
, -Program
, -State
GLArrayData
and GLUniformData
Surface
/ FBObject
OpenGL
ContextOpenAL
SupportGraphUI
SupportTTF
FontFFMpeg
video playbackGraphUI
ScenegraphSDL2
with SDL3
C++ API documentation, with topics:
lint
validationeclipse
and vscodium
integrationInstalling build dependencies for Debian >= 12 and Ubuntu >= 22:
If using optional clang toolchain, perhaps change the clang version-suffix of above clang install line to the appropriate version.
After complete clang installation, you might want to setup the latest version as your default. For Debian you can use this clang alternatives setup script.
Analog to jaulib CMake build presets ...
Following debug presets are defined in CMakePresets.json
debug
clang-tidy
debug-gcc
debug
gcc
clang-tidy
debug-clang
debug
clang
clang-tidy
release
debug
clang-tidy
release-gcc
gcc
clang-tidy
release-clang
clang
clang-tidy
release-wasm
clang / emscripten
clang-tidy
emcmake
Kick-off the workflow by e.g. using preset release-gcc
to configure, build, test, install and building documentation. You may skip install
and doc
by dropping it from --target
.
You may utilize scripts/build-preset.sh
for an initial build, install and test workflow.
Analog to jaulib CMake hardcoded presets ...
Besides above CMakePresets.json
presets, JaulibSetup.cmake
contains hardcoded presets for undefined variables if
CMAKE_INSTALL_PREFIX
and CMAKE_CXX_CLANG_TIDY
cmake variables are unset, orJAU_CMAKE_ENFORCE_PRESETS
cmake- or environment-variable is set to TRUE
or ON
The hardcoded presets resemble debug-clang
presets.
Kick-off the workflow to configure, build, test, install and building documentation. You may skip install
and doc
by dropping it from --target
.
The install target of the last command will create the include/ and lib/ directories with a copy of the headers and library objects respectively in your dist location.
Our cmake configure has a number of options, cmake-gui or ccmake can show you all the options. The interesting ones are detailed below:
See jaulib CMake variables for details.
TBD
Will be updated
Tested Eclipse 2024-03 (4.31).
IDE integration configuration files are provided for
https://download.eclipse.org/tools/cdt/releases/cdt-lsp-latest
C/C++ LSP Support
in the Eclipse CDT LSP Category
CMake Support
, install C/C++ CMake Build Support
with ID org.eclipse.cdt.cmake.feature.group
debug-clang
The Hardcoded CMake Presets will use build/default
as the default build folder with debug enabled.
Make sure to set the environment variable CMAKE_BUILD_PARALLEL_LEVEL
to a suitable high number, best to your CPU core count. This will enable parallel build with the IDE.
You can import the project to your workspace via File . Import...
and Existing Projects into Workspace
menu item.
For Eclipse one might need to adjust some setting in the .project
and .cproject
(CDT) via Eclipse settings UI, but it should just work out of the box.
Otherwise recreate the Eclipse project by
.project
and .cproject
File . New . C/C++ Project
and Empty or Existing CMake Project
while using this project folder.IDE integration configuration files are provided for
For VSCodium one might copy the example root-workspace file to the parent folder of this project (note the filename change) and adjust the path
to your filesystem.
Then you can open it via File . Open Workspace from File...
menu item.
Gamp is lead by Gothel Software.
If you like to utilize Gamp in a commercial setting, please contact Gothel Software to setup a potential support contract or just help to fund the ongoing effort.
Bugtracker etc to be setup at a later stage.
See Changes.