# | |
# FreeType 2 library sub-Makefile | |
# | |
# Copyright 1996-2015 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: | |
# | |
# BUILD_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 | |
# 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/reference | |
# 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) \ | |
$(BUILD_DIR) \ | |
$(TOP_DIR)/include) | |
INCLUDE_FLAGS := $(INCLUDES:%=$I%) | |
ifdef DEVEL_DIR | |
# We assume that all library dependencies for FreeType are fulfilled for a | |
# development build, so we directly access the necessary include directory | |
# information using `pkg-config'. | |
INCLUDE_FLAGS += $(shell pkg-config --cflags libpng \ | |
harfbuzz ) | |
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). | |
# | |
# Finally, we define FT_CONFIG_MODULES_H so that the compiler uses the | |
# generated version of `ftmodule.h' in $(OBJ_DIR). If there is an | |
# `ftoption.h' files in $(OBJ_DIR), define FT_CONFIG_OPTIONS_H too. | |
# | |
ifneq ($(wildcard $(OBJ_DIR)/ftoption.h),) | |
FTOPTION_H := $(OBJ_DIR)/ftoption.h | |
FTOPTION_FLAG := $DFT_CONFIG_OPTIONS_H="<ftoption.h>" | |
endif | |
# `CPPFLAGS' might be specified by the user in the environment. | |
# | |
FT_CFLAGS = $(CPPFLAGS) \ | |
$(CFLAGS) \ | |
$DFT2_BUILD_LIBRARY \ | |
$DFT_CONFIG_MODULES_H="<ftmodule.h>" \ | |
$(FTOPTION_FLAG) | |
# 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. | |
# | |
# This is used to simplify the dependency rules -- if one of these files | |
# changes, the whole library is recompiled. | |
# | |
PUBLIC_H := $(wildcard $(PUBLIC_DIR)/*.h) | |
INTERNAL_H := $(wildcard $(INTERNAL_DIR)/*.h) \ | |
$(wildcard $(SERVICES_DIR)/*.h) | |
CONFIG_H := $(wildcard $(CONFIG_DIR)/*.h) \ | |
$(wildcard $(BUILD_DIR)/config/*.h) \ | |
$(FTMODULE_H) \ | |
$(FTOPTION_H) | |
DEVEL_H := $(wildcard $(TOP_DIR)/devel/*.h) | |
FREETYPE_H := $(PUBLIC_H) $(INTERNAL_H) $(CONFIG_H) $(DEVEL_H) | |
FT_COMPILE := $(CC) $(ANSIFLAGS) $(INCLUDE_FLAGS) $(FT_CFLAGS) | |
# 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)) | |
# 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),$@ $<) | |
# All FreeType library objects. | |
# | |
OBJ_M := $(BASE_OBJ_M) $(BASE_EXT_OBJ) $(DRV_OBJS_M) | |
OBJ_S := $(BASE_OBJ_S) $(BASE_EXT_OBJ) $(DRV_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) | |
# Option `-B' disables generation of .pyc files (available since python 2.6) | |
# | |
refdoc: | |
python -B $(SRC_DIR)/tools/docmaker/docmaker.py \ | |
--prefix=ft2 \ | |
--title=FreeType-$(version) \ | |
--output=$(DOC_DIR) \ | |
$(PUBLIC_DIR)/*.h \ | |
$(PUBLIC_DIR)/config/*.h \ | |
$(PUBLIC_DIR)/cache/*.h | |
.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_freetype' and | |
# `distclean_freetype'. 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 |