Библиотека C с одним заголовком вызывает ошибки компоновки. Как я могу изменить структуру проекта, чтобы исправить это?

В настоящее время я использую small3dlib с SDL, чтобы попытаться создать простую 3D-игру.

Я включил библиотеку в свой проект C, просто поместив заголовочный файл в исходный каталог, и создал два файла, gfx.c и gfx.h, которые служат для управления графикой для всего проекта.

Моя текущая структура проекта выглядит так:

tsa-3d/
| bin/
| build/
| src/
|-- gfx.c
|-- main.c
|-- include/
|---- gfx.h
|---- logger.h
|---- loggerconf.h
|---- models.h
|---- small3dlib.h
|---- tgc.h
|-- lib/
|---- logger.c
|---- loggerconf.c
|---- tgc.c
|-- models/
|---- carModel.c
|---- cityModel.c
|---- cityTexture.c

Из них только файлы, включающие small3dlib (косвенно), это main.c, gfx.c/.h, models.h и все модели.

Библиотека требует, чтобы несколько макросов были определены перед включением, поэтому мне нужно каждый раз вызывать заголовок моего графического интерфейса gfx.h, а не small3dlib.h.

#ifndef GFX_H
#define GFX_H

#define S3L_FLAT 0
#define S3L_NEAR_CROSS_STRATEGY 3
#define S3L_PERSPECTIVE_CORRECTION 2
#define S3L_SORT 0
#define S3L_STENCIL_BUFFER 0
#define S3L_Z_BUFFER 2

#define S3L_PIXEL_FUNCTION draw_pixel

#define S3L_RESOLUTION_X 640
#define S3L_RESOLUTION_Y 480

#define TEXTURE_W 256
#define TEXTURE_H 256

#define WINDOW_TITLE "hello, world"

#include <SDL2/SDL.h>
#include <stdint.h>
#include "small3dlib.h"
#include "models.h"

...

В результате этого макета у меня есть следующая ошибка связывания для каждой функции, определенной в small3dlib.h:

/usr/bin/ld: src/main.o:(.bss+0x0): multiple definition of `S3L_zBuffer'; src/gfx.o:(.bss+0x0): first defined here
/usr/bin/ld: src/main.o: in function `S3L_zBufferRead':
main.c:(.text+0x7d): multiple definition of `S3L_zBufferRead'; src/gfx.o:gfx.c:(.text+0x7d): first defined here
/usr/bin/ld: src/main.o: in function `S3L_zBufferWrite':
main.c:(.text+0xb9): multiple definition of `S3L_zBufferWrite'; src/gfx.o:gfx.c:(.text+0xb9): first defined here
/usr/bin/ld: src/main.o: in function `S3L_mat4Copy':
...

У меня была такая же проблема и для всех моделей (все они были получены из проекта и изначально имели определения переменных/функций в заголовках, пока я не разделил их только на файлы .c и один общий заголовок.

Я огляделся столько, сколько мог, и я не уверен, что мне нужно сделать, чтобы исправить это. Я знаю, что определения переменных и функций не должны помещаться в файлы заголовков, но вся эта библиотека построена на том, что все определения находятся в одном заголовке. Все примеры программ для этой библиотеки имеют small3dlib.h, включенный только в один файл .c, так что в таком случае, как эта библиотека предназначена для использования, когда она включена в несколько файлов?

Полный код проекта на данный момент можно найти здесь . Это попытка адаптации примера города в репозитории библиотеки.

Я попытался разделить библиотеку на заголовочный файл и исходный файл, чтобы все функции теперь просто прототипировались в заголовке. Этот вариант не удался, потому что сам заголовок невероятно велик, а преобразование каждого определения функции в объявление и знание того, какие функции нужно преобразовать, а какие нет, утомительно и утомительно для 2800 строк C. После попытки сделать это около получаса , я предположил, что, скорее всего, просто делаю что-то не так, пытаясь связать библиотеку, и что библиотека, скорее всего, не виновата в этой проблеме.

Обновлено: это минимальный воспроизводимый пример этого:

Вот пример того, что здесь происходит:

Файловая структура:

project/
| Makefile
| src/
|-- main.c
|-- foo.c
|-- include/
|---- something.h
|---- lib.h

Makefile

# Global

SRC := $(wildcard src/*.c) \
       $(wildcard src/**/*.c) \
       $(wildcard src/**/**/*.c) \
       $(wildcard src/**/**/**/*.c)

OUT := program

# Default Build

EXE := ./build/${OUT}
CFLAGS := -I./src/include
LIBFLAGS := -lSDL2 -ldl
OBJ := ${SRC:.c=.o}

build: clean-obj dir ${OBJ}
    gcc ${OBJ} -o ${EXE} ${CFLAGS} ${LIBFLAGS}
    ${call clean-obj}

%.o: %.c
    gcc -c $< -o $@ ${CFLAGS}

run: build
    ./bin/${OUT}

# Utility

dir:
    mkdir -p ./bin ./build/

clean-obj:
    rm -f ${OBJ} ./bin/*

clean: clean-obj
    rm -f ${EXE}

Lib.h -> представление small3dlib.h

#ifndef LIB_H
#define LIB_H

#include <stdint.h>
#include <stdio.h>

#ifndef SOME_MACRO
    #error SOME_MACRO NOT DEFINED!
#endif

#define ARRAY_LENGTH 3
const uint8_t array[ARRAY_LENGTH] = { 1, 2, 3 };

void hello(uint8_t x) {
    for (uint8_t i = 0; i < x; i++)
        printf("%d", i);
}

#endif

Что-то.ч

#ifndef SOMETHING_H
#define SOMETHING_H

#define SOME_MACRO 3
#include "lib.h"

void bar();

#endif

Main.c

#include "include/something.h"

int main(int argc, char* argv[]) {
    hello(array[2]);
    bar();
}

Foo.c

#include "include/something.h"

void bar() {
    hello(8);
}

Это приводит к:

...
/usr/bin/ld: src/main.o:(.rodata+0x0): multiple definition of `array'; src/foo.o:(.rodata+0x0): first defined here
/usr/bin/ld: src/main.o: in function `hello':
main.c:(.text+0x0): multiple definition of `hello'; src/foo.o:foo.c:(.text+0x0): first defined here
collect2: error: ld returned 1 exit status
make: *** [Makefile:18: build] Error 1