386 lines
11 KiB
Makefile
386 lines
11 KiB
Makefile
#
|
|
# FreeType 2 library sub-Makefile
|
|
#
|
|
|
|
|
|
# Copyright (C) 1996-2024 by
|
|
# David Turner, Robert Wilhelm, and Werner Lemberg.
|
|
#
|
|
# This file is part of the FreeType project, and may only be used, modified,
|
|
# and distributed under the terms of the FreeType project license,
|
|
# LICENSE.TXT. By continuing to use, modify, or distribute this file you
|
|
# indicate that you have read the license and understand and accept it
|
|
# fully.
|
|
|
|
|
|
# DO NOT INVOKE THIS MAKEFILE DIRECTLY! IT IS MEANT TO BE INCLUDED BY
|
|
# OTHER MAKEFILES.
|
|
|
|
|
|
# The following variables (set by other Makefile components, in the
|
|
# environment, or on the command line) are used:
|
|
#
|
|
# PLATFORM_DIR The architecture-dependent directory,
|
|
# e.g., `$(TOP_DIR)/builds/unix'. Added to INCLUDES also.
|
|
#
|
|
# OBJ_DIR The directory in which object files are created.
|
|
#
|
|
# LIB_DIR The directory in which the library is created.
|
|
#
|
|
# DOC_DIR The directory in which the API reference is created.
|
|
#
|
|
# INCLUDES A list of directories to be included additionally.
|
|
#
|
|
# DEVEL_DIR Development directory which is added to the INCLUDES
|
|
# variable before the standard include directories.
|
|
#
|
|
# CFLAGS Compilation flags. This overrides the default settings
|
|
# in the platform-specific configuration files.
|
|
#
|
|
# FTSYS_SRC If set, its value is used as the name of a replacement
|
|
# file for `src/base/ftsystem.c'.
|
|
#
|
|
# FTDEBUG_SRC If set, its value is used as the name of a replacement
|
|
# file for `src/base/ftdebug.c'. [For a normal build, this
|
|
# file does nothing.]
|
|
#
|
|
# FTMODULE_H The file which contains the list of module classes for
|
|
# the current build. Usually, this is automatically
|
|
# created by `modules.mk'.
|
|
#
|
|
# BASE_OBJ_S
|
|
# BASE_OBJ_M A list of base objects (for single object and multiple
|
|
# object builds, respectively). Set up in
|
|
# `src/base/rules.mk'.
|
|
#
|
|
# BASE_EXT_OBJ A list of base extension objects. Set up in
|
|
# `src/base/rules.mk'.
|
|
#
|
|
# DRV_OBJ_S
|
|
# DRV_OBJ_M A list of driver objects (for single object and multiple
|
|
# object builds, respectively). Set up cumulatively in
|
|
# `src/<driver>/rules.mk'.
|
|
#
|
|
# CLEAN
|
|
# DISTCLEAN The sub-makefiles can append additional stuff to these two
|
|
# variables which is to be removed for the `clean' resp.
|
|
# `distclean' target.
|
|
#
|
|
# TOP_DIR, SEP,
|
|
# COMPILER_SEP,
|
|
# LIBRARY, CC,
|
|
# A, I, O, T Check `config.mk' for details.
|
|
|
|
|
|
# The targets `objects' and `library' are defined at the end of this
|
|
# Makefile after all other rules have been included.
|
|
#
|
|
.PHONY: single multi objects library refdoc refdoc-venv
|
|
|
|
# default target -- build single objects and library
|
|
#
|
|
single: objects library
|
|
|
|
# `multi' target -- build multiple objects and library
|
|
#
|
|
multi: objects library
|
|
|
|
|
|
# The FreeType source directory, usually `./src'.
|
|
#
|
|
SRC_DIR := $(TOP_DIR)/src
|
|
|
|
# The directory where the base layer components are placed, usually
|
|
# `./src/base'.
|
|
#
|
|
BASE_DIR := $(SRC_DIR)/base
|
|
|
|
# Other derived directories.
|
|
#
|
|
PUBLIC_DIR := $(TOP_DIR)/include/freetype
|
|
INTERNAL_DIR := $(PUBLIC_DIR)/internal
|
|
SERVICES_DIR := $(INTERNAL_DIR)/services
|
|
CONFIG_DIR := $(PUBLIC_DIR)/config
|
|
|
|
# The documentation directory.
|
|
#
|
|
DOC_DIR ?= $(TOP_DIR)/docs
|
|
|
|
# The final name of the library file.
|
|
#
|
|
PROJECT_LIBRARY := $(LIB_DIR)/$(LIBRARY).$A
|
|
|
|
|
|
# include paths
|
|
#
|
|
# IMPORTANT NOTE: The architecture-dependent directory must ALWAYS be placed
|
|
# before the standard include list. Porters are then able to
|
|
# put their own version of some of the FreeType components
|
|
# in the `builds/<system>' directory, as these files will
|
|
# override the default sources.
|
|
#
|
|
INCLUDES := $(subst /,$(COMPILER_SEP),$(OBJ_DIR) \
|
|
$(DEVEL_DIR) \
|
|
$(PLATFORM_DIR) \
|
|
$(TOP_DIR)/include)
|
|
|
|
INCLUDE_FLAGS := $(INCLUDES:%=$I%)
|
|
|
|
# For a development build, we assume that the external library dependencies
|
|
# defined in `ftoption.h' are fulfilled, so we directly access the necessary
|
|
# include directory information using `pkg-config'.
|
|
#
|
|
ifdef DEVEL_DIR
|
|
INCLUDE_FLAGS += $(shell pkg-config --cflags libpng)
|
|
INCLUDE_FLAGS += $(shell pkg-config --cflags harfbuzz)
|
|
INCLUDE_FLAGS += $(shell pkg-config --cflags libbrotlidec)
|
|
endif
|
|
|
|
|
|
# C flags used for the compilation of an object file. This must include at
|
|
# least the paths for the `base' and `builds/<system>' directories;
|
|
# debug/optimization/warning flags + ansi compliance if needed.
|
|
#
|
|
# $(INCLUDE_FLAGS) should come before $(CFLAGS) to avoid problems with
|
|
# old FreeType versions.
|
|
#
|
|
# Note what we also define the macro FT2_BUILD_LIBRARY when building
|
|
# FreeType. This is required to let our sources include the internal
|
|
# headers (something forbidden by clients).
|
|
#
|
|
# `CPPFLAGS' might be specified by the user in the environment.
|
|
#
|
|
FT_CFLAGS = $(CPPFLAGS) \
|
|
$(CFLAGS) \
|
|
$DFT2_BUILD_LIBRARY
|
|
|
|
FT_COMPILE := $(CC) $(ANSIFLAGS) $(INCLUDE_FLAGS) $(FT_CFLAGS)
|
|
|
|
|
|
# Include the `exports' rules file.
|
|
#
|
|
include $(TOP_DIR)/builds/exports.mk
|
|
|
|
|
|
# Initialize the list of objects.
|
|
#
|
|
OBJECTS_LIST :=
|
|
|
|
|
|
# Define $(PUBLIC_H) as the list of all public header files located in
|
|
# `$(TOP_DIR)/include/freetype'. $(INTERNAL_H), and $(CONFIG_H) are defined
|
|
# similarly. $(FTOPTION_H) is the option file used in the compilation.
|
|
#
|
|
# This is used to simplify the dependency rules -- if one of these files
|
|
# changes, the whole library is recompiled.
|
|
#
|
|
ifneq ($(wildcard $(OBJ_DIR)/ftoption.h),)
|
|
FTOPTION_H := $(OBJ_DIR)/ftoption.h
|
|
else ifneq ($(wildcard $(PLATFORM_DIR)/ftoption.h),)
|
|
FTOPTION_H := $(PLATFORM_DIR)/ftoption.h
|
|
endif
|
|
|
|
PUBLIC_H := $(wildcard $(PUBLIC_DIR)/*.h)
|
|
INTERNAL_H := $(wildcard $(INTERNAL_DIR)/*.h) \
|
|
$(wildcard $(SERVICES_DIR)/*.h)
|
|
CONFIG_H := $(wildcard $(CONFIG_DIR)/*.h) \
|
|
$(wildcard $(PLATFORM_DIR)/config/*.h) \
|
|
$(FTMODULE_H) \
|
|
$(FTOPTION_H)
|
|
DEVEL_H := $(wildcard $(TOP_DIR)/devel/*.h)
|
|
|
|
FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H)
|
|
|
|
|
|
# ftsystem component
|
|
#
|
|
FTSYS_SRC ?= $(BASE_DIR)/ftsystem.c
|
|
|
|
FTSYS_OBJ := $(OBJ_DIR)/ftsystem.$O
|
|
|
|
OBJECTS_LIST += $(FTSYS_OBJ)
|
|
|
|
$(FTSYS_OBJ): $(FTSYS_SRC) $(FREETYPE_H)
|
|
$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
|
|
|
|
|
|
# ftdebug component
|
|
#
|
|
FTDEBUG_SRC ?= $(BASE_DIR)/ftdebug.c
|
|
|
|
FTDEBUG_OBJ := $(OBJ_DIR)/ftdebug.$O
|
|
|
|
OBJECTS_LIST += $(FTDEBUG_OBJ)
|
|
|
|
$(FTDEBUG_OBJ): $(FTDEBUG_SRC) $(FREETYPE_H)
|
|
$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
|
|
|
|
|
|
# Include all rule files from FreeType components.
|
|
#
|
|
include $(SRC_DIR)/base/rules.mk
|
|
include $(patsubst %,$(SRC_DIR)/%/rules.mk,$(MODULES))
|
|
include $(SRC_DIR)/dlg/rules.mk
|
|
|
|
|
|
# ftinit component
|
|
#
|
|
# The C source `ftinit.c' contains the FreeType initialization routines.
|
|
# It is able to automatically register one or more drivers when the API
|
|
# function FT_Init_FreeType() is called.
|
|
#
|
|
# The set of initial drivers is determined by the driver Makefiles
|
|
# includes above. Each driver Makefile updates the FTINIT_xxx lists
|
|
# which contain additional include paths and macros used to compile the
|
|
# single `ftinit.c' source.
|
|
#
|
|
FTINIT_SRC := $(BASE_DIR)/ftinit.c
|
|
FTINIT_OBJ := $(OBJ_DIR)/ftinit.$O
|
|
|
|
OBJECTS_LIST += $(FTINIT_OBJ)
|
|
|
|
$(FTINIT_OBJ): $(FTINIT_SRC) $(FREETYPE_H)
|
|
$(FT_COMPILE) $T$(subst /,$(COMPILER_SEP),$@ $<)
|
|
|
|
|
|
# ftver component
|
|
#
|
|
# The VERSIONINFO resource `ftver.rc' contains version and copyright
|
|
# to be compiled by windres and tagged into DLL usually.
|
|
#
|
|
ifneq ($(RC),)
|
|
FTVER_SRC := $(BASE_DIR)/ftver.rc
|
|
FTVER_OBJ := $(OBJ_DIR)/ftver.$O
|
|
|
|
OBJECTS_LIST += $(FTVER_OBJ)
|
|
|
|
$(FTVER_OBJ): $(FTVER_SRC)
|
|
$(RC) -o $@ $<
|
|
endif
|
|
|
|
|
|
# All FreeType library objects.
|
|
#
|
|
OBJ_M := $(BASE_OBJ_M) $(BASE_EXT_OBJ) $(DRV_OBJS_M) $(DLG_OBJS_M)
|
|
OBJ_S := $(BASE_OBJ_S) $(BASE_EXT_OBJ) $(DRV_OBJS_S) $(DLG_OBJS_S)
|
|
|
|
|
|
# The target `multi' on the Make command line indicates that we want to
|
|
# compile each source file independently.
|
|
#
|
|
# Otherwise, each module/driver is compiled in a single object file through
|
|
# source file inclusion (see `src/base/ftbase.c' or
|
|
# `src/truetype/truetype.c' for examples).
|
|
#
|
|
BASE_OBJECTS := $(OBJECTS_LIST)
|
|
|
|
ifneq ($(findstring multi,$(MAKECMDGOALS)),)
|
|
OBJECTS_LIST += $(OBJ_M)
|
|
else
|
|
OBJECTS_LIST += $(OBJ_S)
|
|
endif
|
|
|
|
objects: $(OBJECTS_LIST)
|
|
|
|
library: $(PROJECT_LIBRARY)
|
|
|
|
# Run `docwriter' in the current Python environment.
|
|
#
|
|
PYTHON ?= python
|
|
|
|
refdoc:
|
|
@echo Running docwriter...
|
|
$(PYTHON) -m docwriter \
|
|
--prefix=ft2 \
|
|
--title=FreeType-$(version) \
|
|
--site=reference \
|
|
--output=$(DOC_DIR) \
|
|
$(PUBLIC_DIR)/*.h \
|
|
$(PUBLIC_DIR)/config/*.h \
|
|
$(PUBLIC_DIR)/cache/*.h
|
|
@echo Building static site...
|
|
cd $(DOC_DIR) && $(PYTHON) -m mkdocs build
|
|
@echo Done.
|
|
|
|
# Variables for running `refdoc' with Python's `virtualenv'. The
|
|
# environment is created in `DOC_DIR/env' and is gitignored.
|
|
#
|
|
# We still need to cd into `DOC_DIR' to build `mkdocs' because paths in
|
|
# `mkdocs.yml' are relative to the current working directory.
|
|
#
|
|
VENV_NAME := env
|
|
VENV_DIR := $(DOC_DIR)$(SEP)$(VENV_NAME)
|
|
ENV_PYTHON := $(VENV_DIR)$(SEP)$(BIN)$(SEP)$(PYTHON)
|
|
|
|
refdoc-venv:
|
|
@echo Setting up virtualenv for Python...
|
|
virtualenv --python=$(PYTHON) $(VENV_DIR)
|
|
@echo Installing docwriter...
|
|
$(ENV_PYTHON) -m pip install docwriter
|
|
@echo Running docwriter...
|
|
$(ENV_PYTHON) -m docwriter \
|
|
--prefix=ft2 \
|
|
--title=FreeType-$(version) \
|
|
--site=reference \
|
|
--output=$(DOC_DIR) \
|
|
$(PUBLIC_DIR)/*.h \
|
|
$(PUBLIC_DIR)/config/*.h \
|
|
$(PUBLIC_DIR)/cache/*.h
|
|
@echo Building static site...
|
|
cd $(DOC_DIR) && $(VENV_NAME)$(SEP)$(BIN)$(SEP)python -m mkdocs build
|
|
@echo Done.
|
|
|
|
.PHONY: clean_project_std distclean_project_std
|
|
|
|
# Standard cleaning and distclean rules. These are not accepted
|
|
# on all systems though.
|
|
#
|
|
clean_project_std:
|
|
-$(DELETE) $(BASE_OBJECTS) $(OBJ_M) $(OBJ_S) $(CLEAN)
|
|
|
|
distclean_project_std: clean_project_std
|
|
-$(DELETE) $(PROJECT_LIBRARY)
|
|
-$(DELETE) *.orig *~ core *.core $(DISTCLEAN)
|
|
|
|
|
|
.PHONY: clean_project_dos distclean_project_dos
|
|
|
|
# The Dos command shell does not support very long list of arguments, so
|
|
# we are stuck with wildcards.
|
|
#
|
|
# Don't break the command lines with \; this prevents the "del" command from
|
|
# working correctly on Win9x.
|
|
#
|
|
clean_project_dos:
|
|
-$(DELETE) $(subst /,$(SEP),$(OBJ_DIR)/*.$O $(CLEAN) $(NO_OUTPUT))
|
|
|
|
distclean_project_dos: clean_project_dos
|
|
-$(DELETE) $(subst /,$(SEP),$(PROJECT_LIBRARY) $(DISTCLEAN) $(NO_OUTPUT))
|
|
|
|
|
|
.PHONY: remove_config_mk remove_ftmodule_h
|
|
|
|
# Remove configuration file (used for distclean).
|
|
#
|
|
remove_config_mk:
|
|
-$(DELETE) $(subst /,$(SEP),$(CONFIG_MK) $(NO_OUTPUT))
|
|
|
|
# Remove module list (used for distclean).
|
|
#
|
|
remove_ftmodule_h:
|
|
-$(DELETE) $(subst /,$(SEP),$(FTMODULE_H) $(NO_OUTPUT))
|
|
|
|
|
|
.PHONY: clean distclean
|
|
|
|
# The `config.mk' file must define `clean_project' and `distclean_project'.
|
|
# Implementations may use to relay these to either the `std' or `dos'
|
|
# versions from above, or simply provide their own implementation.
|
|
#
|
|
clean: clean_project
|
|
distclean: distclean_project remove_config_mk remove_ftmodule_h
|
|
-$(DELETE) $(subst /,$(SEP),$(DOC_DIR)/*.html $(NO_OUTPUT))
|
|
|
|
|
|
# EOF
|