commit
408b25f1f1
@ -0,0 +1,63 @@ |
||||
############################################################################### |
||||
# Set default behavior to automatically normalize line endings. |
||||
############################################################################### |
||||
* text=auto |
||||
|
||||
############################################################################### |
||||
# Set default behavior for command prompt diff. |
||||
# |
||||
# This is need for earlier builds of msysgit that does not have it on by |
||||
# default for csharp files. |
||||
# Note: This is only used by command line |
||||
############################################################################### |
||||
#*.cs diff=csharp |
||||
|
||||
############################################################################### |
||||
# Set the merge driver for project and solution files |
||||
# |
||||
# Merging from the command prompt will add diff markers to the files if there |
||||
# are conflicts (Merging from VS is not affected by the settings below, in VS |
||||
# the diff markers are never inserted). Diff markers may cause the following |
||||
# file extensions to fail to load in VS. An alternative would be to treat |
||||
# these files as binary and thus will always conflict and require user |
||||
# intervention with every merge. To do so, just uncomment the entries below |
||||
############################################################################### |
||||
#*.sln merge=binary |
||||
#*.csproj merge=binary |
||||
#*.vbproj merge=binary |
||||
#*.vcxproj merge=binary |
||||
#*.vcproj merge=binary |
||||
#*.dbproj merge=binary |
||||
#*.fsproj merge=binary |
||||
#*.lsproj merge=binary |
||||
#*.wixproj merge=binary |
||||
#*.modelproj merge=binary |
||||
#*.sqlproj merge=binary |
||||
#*.wwaproj merge=binary |
||||
|
||||
############################################################################### |
||||
# behavior for image files |
||||
# |
||||
# image files are treated as binary by default. |
||||
############################################################################### |
||||
#*.jpg binary |
||||
#*.png binary |
||||
#*.gif binary |
||||
|
||||
############################################################################### |
||||
# diff behavior for common document formats |
||||
# |
||||
# Convert binary document formats to text before diffing them. This feature |
||||
# is only available from the command line. Turn it on by uncommenting the |
||||
# entries below. |
||||
############################################################################### |
||||
#*.doc diff=astextplain |
||||
#*.DOC diff=astextplain |
||||
#*.docx diff=astextplain |
||||
#*.DOCX diff=astextplain |
||||
#*.dot diff=astextplain |
||||
#*.DOT diff=astextplain |
||||
#*.pdf diff=astextplain |
||||
#*.PDF diff=astextplain |
||||
#*.rtf diff=astextplain |
||||
#*.RTF diff=astextplain |
||||
@ -0,0 +1,363 @@ |
||||
## Ignore Visual Studio temporary files, build results, and |
||||
## files generated by popular Visual Studio add-ons. |
||||
## |
||||
## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore |
||||
|
||||
# User-specific files |
||||
*.rsuser |
||||
*.suo |
||||
*.user |
||||
*.userosscache |
||||
*.sln.docstates |
||||
|
||||
# User-specific files (MonoDevelop/Xamarin Studio) |
||||
*.userprefs |
||||
|
||||
# Mono auto generated files |
||||
mono_crash.* |
||||
|
||||
# Build results |
||||
[Dd]ebug/ |
||||
[Dd]ebugPublic/ |
||||
[Rr]elease/ |
||||
[Rr]eleases/ |
||||
x64/ |
||||
x86/ |
||||
[Ww][Ii][Nn]32/ |
||||
[Aa][Rr][Mm]/ |
||||
[Aa][Rr][Mm]64/ |
||||
bld/ |
||||
[Bb]in/ |
||||
[Oo]bj/ |
||||
[Oo]ut/ |
||||
[Ll]og/ |
||||
[Ll]ogs/ |
||||
|
||||
# Visual Studio 2015/2017 cache/options directory |
||||
.vs/ |
||||
# Uncomment if you have tasks that create the project's static files in wwwroot |
||||
#wwwroot/ |
||||
|
||||
# Visual Studio 2017 auto generated files |
||||
Generated\ Files/ |
||||
|
||||
# MSTest test Results |
||||
[Tt]est[Rr]esult*/ |
||||
[Bb]uild[Ll]og.* |
||||
|
||||
# NUnit |
||||
*.VisualState.xml |
||||
TestResult.xml |
||||
nunit-*.xml |
||||
|
||||
# Build Results of an ATL Project |
||||
[Dd]ebugPS/ |
||||
[Rr]eleasePS/ |
||||
dlldata.c |
||||
|
||||
# Benchmark Results |
||||
BenchmarkDotNet.Artifacts/ |
||||
|
||||
# .NET Core |
||||
project.lock.json |
||||
project.fragment.lock.json |
||||
artifacts/ |
||||
|
||||
# ASP.NET Scaffolding |
||||
ScaffoldingReadMe.txt |
||||
|
||||
# StyleCop |
||||
StyleCopReport.xml |
||||
|
||||
# Files built by Visual Studio |
||||
*_i.c |
||||
*_p.c |
||||
*_h.h |
||||
*.ilk |
||||
*.meta |
||||
*.obj |
||||
*.iobj |
||||
*.pch |
||||
*.pdb |
||||
*.ipdb |
||||
*.pgc |
||||
*.pgd |
||||
*.rsp |
||||
*.sbr |
||||
*.tlb |
||||
*.tli |
||||
*.tlh |
||||
*.tmp |
||||
*.tmp_proj |
||||
*_wpftmp.csproj |
||||
*.log |
||||
*.vspscc |
||||
*.vssscc |
||||
.builds |
||||
*.pidb |
||||
*.svclog |
||||
*.scc |
||||
|
||||
# Chutzpah Test files |
||||
_Chutzpah* |
||||
|
||||
# Visual C++ cache files |
||||
ipch/ |
||||
*.aps |
||||
*.ncb |
||||
*.opendb |
||||
*.opensdf |
||||
*.sdf |
||||
*.cachefile |
||||
*.VC.db |
||||
*.VC.VC.opendb |
||||
|
||||
# Visual Studio profiler |
||||
*.psess |
||||
*.vsp |
||||
*.vspx |
||||
*.sap |
||||
|
||||
# Visual Studio Trace Files |
||||
*.e2e |
||||
|
||||
# TFS 2012 Local Workspace |
||||
$tf/ |
||||
|
||||
# Guidance Automation Toolkit |
||||
*.gpState |
||||
|
||||
# ReSharper is a .NET coding add-in |
||||
_ReSharper*/ |
||||
*.[Rr]e[Ss]harper |
||||
*.DotSettings.user |
||||
|
||||
# TeamCity is a build add-in |
||||
_TeamCity* |
||||
|
||||
# DotCover is a Code Coverage Tool |
||||
*.dotCover |
||||
|
||||
# AxoCover is a Code Coverage Tool |
||||
.axoCover/* |
||||
!.axoCover/settings.json |
||||
|
||||
# Coverlet is a free, cross platform Code Coverage Tool |
||||
coverage*.json |
||||
coverage*.xml |
||||
coverage*.info |
||||
|
||||
# Visual Studio code coverage results |
||||
*.coverage |
||||
*.coveragexml |
||||
|
||||
# NCrunch |
||||
_NCrunch_* |
||||
.*crunch*.local.xml |
||||
nCrunchTemp_* |
||||
|
||||
# MightyMoose |
||||
*.mm.* |
||||
AutoTest.Net/ |
||||
|
||||
# Web workbench (sass) |
||||
.sass-cache/ |
||||
|
||||
# Installshield output folder |
||||
[Ee]xpress/ |
||||
|
||||
# DocProject is a documentation generator add-in |
||||
DocProject/buildhelp/ |
||||
DocProject/Help/*.HxT |
||||
DocProject/Help/*.HxC |
||||
DocProject/Help/*.hhc |
||||
DocProject/Help/*.hhk |
||||
DocProject/Help/*.hhp |
||||
DocProject/Help/Html2 |
||||
DocProject/Help/html |
||||
|
||||
# Click-Once directory |
||||
publish/ |
||||
|
||||
# Publish Web Output |
||||
*.[Pp]ublish.xml |
||||
*.azurePubxml |
||||
# Note: Comment the next line if you want to checkin your web deploy settings, |
||||
# but database connection strings (with potential passwords) will be unencrypted |
||||
*.pubxml |
||||
*.publishproj |
||||
|
||||
# Microsoft Azure Web App publish settings. Comment the next line if you want to |
||||
# checkin your Azure Web App publish settings, but sensitive information contained |
||||
# in these scripts will be unencrypted |
||||
PublishScripts/ |
||||
|
||||
# NuGet Packages |
||||
*.nupkg |
||||
# NuGet Symbol Packages |
||||
*.snupkg |
||||
# The packages folder can be ignored because of Package Restore |
||||
**/[Pp]ackages/* |
||||
# except build/, which is used as an MSBuild target. |
||||
!**/[Pp]ackages/build/ |
||||
# Uncomment if necessary however generally it will be regenerated when needed |
||||
#!**/[Pp]ackages/repositories.config |
||||
# NuGet v3's project.json files produces more ignorable files |
||||
*.nuget.props |
||||
*.nuget.targets |
||||
|
||||
# Microsoft Azure Build Output |
||||
csx/ |
||||
*.build.csdef |
||||
|
||||
# Microsoft Azure Emulator |
||||
ecf/ |
||||
rcf/ |
||||
|
||||
# Windows Store app package directories and files |
||||
AppPackages/ |
||||
BundleArtifacts/ |
||||
Package.StoreAssociation.xml |
||||
_pkginfo.txt |
||||
*.appx |
||||
*.appxbundle |
||||
*.appxupload |
||||
|
||||
# Visual Studio cache files |
||||
# files ending in .cache can be ignored |
||||
*.[Cc]ache |
||||
# but keep track of directories ending in .cache |
||||
!?*.[Cc]ache/ |
||||
|
||||
# Others |
||||
ClientBin/ |
||||
~$* |
||||
*~ |
||||
*.dbmdl |
||||
*.dbproj.schemaview |
||||
*.jfm |
||||
*.pfx |
||||
*.publishsettings |
||||
orleans.codegen.cs |
||||
|
||||
# Including strong name files can present a security risk |
||||
# (https://github.com/github/gitignore/pull/2483#issue-259490424) |
||||
#*.snk |
||||
|
||||
# Since there are multiple workflows, uncomment next line to ignore bower_components |
||||
# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) |
||||
#bower_components/ |
||||
|
||||
# RIA/Silverlight projects |
||||
Generated_Code/ |
||||
|
||||
# Backup & report files from converting an old project file |
||||
# to a newer Visual Studio version. Backup files are not needed, |
||||
# because we have git ;-) |
||||
_UpgradeReport_Files/ |
||||
Backup*/ |
||||
UpgradeLog*.XML |
||||
UpgradeLog*.htm |
||||
ServiceFabricBackup/ |
||||
*.rptproj.bak |
||||
|
||||
# SQL Server files |
||||
*.mdf |
||||
*.ldf |
||||
*.ndf |
||||
|
||||
# Business Intelligence projects |
||||
*.rdl.data |
||||
*.bim.layout |
||||
*.bim_*.settings |
||||
*.rptproj.rsuser |
||||
*- [Bb]ackup.rdl |
||||
*- [Bb]ackup ([0-9]).rdl |
||||
*- [Bb]ackup ([0-9][0-9]).rdl |
||||
|
||||
# Microsoft Fakes |
||||
FakesAssemblies/ |
||||
|
||||
# GhostDoc plugin setting file |
||||
*.GhostDoc.xml |
||||
|
||||
# Node.js Tools for Visual Studio |
||||
.ntvs_analysis.dat |
||||
node_modules/ |
||||
|
||||
# Visual Studio 6 build log |
||||
*.plg |
||||
|
||||
# Visual Studio 6 workspace options file |
||||
*.opt |
||||
|
||||
# Visual Studio 6 auto-generated workspace file (contains which files were open etc.) |
||||
*.vbw |
||||
|
||||
# Visual Studio LightSwitch build output |
||||
**/*.HTMLClient/GeneratedArtifacts |
||||
**/*.DesktopClient/GeneratedArtifacts |
||||
**/*.DesktopClient/ModelManifest.xml |
||||
**/*.Server/GeneratedArtifacts |
||||
**/*.Server/ModelManifest.xml |
||||
_Pvt_Extensions |
||||
|
||||
# Paket dependency manager |
||||
.paket/paket.exe |
||||
paket-files/ |
||||
|
||||
# FAKE - F# Make |
||||
.fake/ |
||||
|
||||
# CodeRush personal settings |
||||
.cr/personal |
||||
|
||||
# Python Tools for Visual Studio (PTVS) |
||||
__pycache__/ |
||||
*.pyc |
||||
|
||||
# Cake - Uncomment if you are using it |
||||
# tools/** |
||||
# !tools/packages.config |
||||
|
||||
# Tabs Studio |
||||
*.tss |
||||
|
||||
# Telerik's JustMock configuration file |
||||
*.jmconfig |
||||
|
||||
# BizTalk build output |
||||
*.btp.cs |
||||
*.btm.cs |
||||
*.odx.cs |
||||
*.xsd.cs |
||||
|
||||
# OpenCover UI analysis results |
||||
OpenCover/ |
||||
|
||||
# Azure Stream Analytics local run output |
||||
ASALocalRun/ |
||||
|
||||
# MSBuild Binary and Structured Log |
||||
*.binlog |
||||
|
||||
# NVidia Nsight GPU debugger configuration file |
||||
*.nvuser |
||||
|
||||
# MFractors (Xamarin productivity tool) working folder |
||||
.mfractor/ |
||||
|
||||
# Local History for Visual Studio |
||||
.localhistory/ |
||||
|
||||
# BeatPulse healthcheck temp database |
||||
healthchecksdb |
||||
|
||||
# Backup folder for Package Reference Convert tool in Visual Studio 2017 |
||||
MigrationBackup/ |
||||
|
||||
# Ionide (cross platform F# VS Code tools) working folder |
||||
.ionide/ |
||||
|
||||
# Fody - auto-generated XML schema |
||||
FodyWeavers.xsd |
||||
File diff suppressed because one or more lines are too long
@ -0,0 +1,166 @@ |
||||
<?xml version="1.0" encoding="utf-8"?> |
||||
<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> |
||||
<ItemGroup Label="ProjectConfigurations"> |
||||
<ProjectConfiguration Include="Debug|Win32"> |
||||
<Configuration>Debug</Configuration> |
||||
<Platform>Win32</Platform> |
||||
</ProjectConfiguration> |
||||
<ProjectConfiguration Include="Release|Win32"> |
||||
<Configuration>Release</Configuration> |
||||
<Platform>Win32</Platform> |
||||
</ProjectConfiguration> |
||||
<ProjectConfiguration Include="Debug|x64"> |
||||
<Configuration>Debug</Configuration> |
||||
<Platform>x64</Platform> |
||||
</ProjectConfiguration> |
||||
<ProjectConfiguration Include="Release|x64"> |
||||
<Configuration>Release</Configuration> |
||||
<Platform>x64</Platform> |
||||
</ProjectConfiguration> |
||||
</ItemGroup> |
||||
<PropertyGroup Label="Globals"> |
||||
<VCProjectVersion>16.0</VCProjectVersion> |
||||
<Keyword>Win32Proj</Keyword> |
||||
<ProjectGuid>{c421608b-8317-4954-89ab-212e3826c3bc}</ProjectGuid> |
||||
<RootNamespace>Test</RootNamespace> |
||||
<WindowsTargetPlatformVersion>10.0</WindowsTargetPlatformVersion> |
||||
<ProjectName>Test</ProjectName> |
||||
</PropertyGroup> |
||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" /> |
||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration"> |
||||
<ConfigurationType>Application</ConfigurationType> |
||||
<UseDebugLibraries>true</UseDebugLibraries> |
||||
<PlatformToolset>v143</PlatformToolset> |
||||
<CharacterSet>Unicode</CharacterSet> |
||||
</PropertyGroup> |
||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration"> |
||||
<ConfigurationType>Application</ConfigurationType> |
||||
<UseDebugLibraries>false</UseDebugLibraries> |
||||
<PlatformToolset>v143</PlatformToolset> |
||||
<WholeProgramOptimization>true</WholeProgramOptimization> |
||||
<CharacterSet>Unicode</CharacterSet> |
||||
</PropertyGroup> |
||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration"> |
||||
<ConfigurationType>Application</ConfigurationType> |
||||
<UseDebugLibraries>true</UseDebugLibraries> |
||||
<PlatformToolset>v143</PlatformToolset> |
||||
<CharacterSet>Unicode</CharacterSet> |
||||
</PropertyGroup> |
||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'" Label="Configuration"> |
||||
<ConfigurationType>Application</ConfigurationType> |
||||
<UseDebugLibraries>false</UseDebugLibraries> |
||||
<PlatformToolset>v143</PlatformToolset> |
||||
<WholeProgramOptimization>true</WholeProgramOptimization> |
||||
<CharacterSet>Unicode</CharacterSet> |
||||
</PropertyGroup> |
||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" /> |
||||
<ImportGroup Label="ExtensionSettings"> |
||||
</ImportGroup> |
||||
<ImportGroup Label="Shared"> |
||||
</ImportGroup> |
||||
<ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'"> |
||||
<Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" /> |
||||
</ImportGroup> |
||||
<ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|Win32'"> |
||||
<Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" /> |
||||
</ImportGroup> |
||||
<ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|x64'"> |
||||
<Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" /> |
||||
</ImportGroup> |
||||
<ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|x64'"> |
||||
<Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" /> |
||||
</ImportGroup> |
||||
<PropertyGroup Label="UserMacros" /> |
||||
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'"> |
||||
<IncludePath>C:\Users\sigon\Documents\asio-1.18.0\include;$(IncludePath)</IncludePath> |
||||
</PropertyGroup> |
||||
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'"> |
||||
<ClCompile> |
||||
<WarningLevel>Level3</WarningLevel> |
||||
<SDLCheck>true</SDLCheck> |
||||
<PreprocessorDefinitions>WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions> |
||||
<ConformanceMode>true</ConformanceMode> |
||||
<LanguageStandard>stdcpp17</LanguageStandard> |
||||
<AdditionalIncludeDirectories>C:\Users\sigon\source\repos\Example\Example\include;C:\Users\sigon\source\repos\Example\Example\src;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories> |
||||
</ClCompile> |
||||
<Link> |
||||
<SubSystem>Console</SubSystem> |
||||
<GenerateDebugInformation>true</GenerateDebugInformation> |
||||
<AdditionalLibraryDirectories>C:\Users\sigon\source\repos\Example\Example\libraries;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories> |
||||
</Link> |
||||
</ItemDefinitionGroup> |
||||
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'"> |
||||
<ClCompile> |
||||
<WarningLevel>Level3</WarningLevel> |
||||
<FunctionLevelLinking>true</FunctionLevelLinking> |
||||
<IntrinsicFunctions>true</IntrinsicFunctions> |
||||
<SDLCheck>true</SDLCheck> |
||||
<PreprocessorDefinitions>WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions> |
||||
<ConformanceMode>true</ConformanceMode> |
||||
<LanguageStandard>stdcpp17</LanguageStandard> |
||||
<AdditionalIncludeDirectories>C:\Users\sigon\source\repos\Example\Example\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories> |
||||
</ClCompile> |
||||
<Link> |
||||
<SubSystem>Console</SubSystem> |
||||
<EnableCOMDATFolding>true</EnableCOMDATFolding> |
||||
<OptimizeReferences>true</OptimizeReferences> |
||||
<GenerateDebugInformation>true</GenerateDebugInformation> |
||||
<AdditionalLibraryDirectories>C:\Users\sigon\source\repos\Example\Example\libraries;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories> |
||||
</Link> |
||||
</ItemDefinitionGroup> |
||||
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'"> |
||||
<ClCompile> |
||||
<WarningLevel>Level3</WarningLevel> |
||||
<SDLCheck>true</SDLCheck> |
||||
<PreprocessorDefinitions>_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions> |
||||
<ConformanceMode>true</ConformanceMode> |
||||
<LanguageStandard>stdcpp17</LanguageStandard> |
||||
<AdditionalIncludeDirectories>C:\Users\sigon\source\repos\Example\Example\include;C:\Users\sigon\source\repos\Example\Example\src;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories> |
||||
</ClCompile> |
||||
<Link> |
||||
<SubSystem>Console</SubSystem> |
||||
<GenerateDebugInformation>true</GenerateDebugInformation> |
||||
<AdditionalLibraryDirectories>C:\Users\sigon\source\repos\Example\Example\libraries;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories> |
||||
</Link> |
||||
</ItemDefinitionGroup> |
||||
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'"> |
||||
<ClCompile> |
||||
<WarningLevel>Level3</WarningLevel> |
||||
<FunctionLevelLinking>true</FunctionLevelLinking> |
||||
<IntrinsicFunctions>true</IntrinsicFunctions> |
||||
<SDLCheck>true</SDLCheck> |
||||
<PreprocessorDefinitions>NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions> |
||||
<ConformanceMode>true</ConformanceMode> |
||||
<LanguageStandard>stdcpp17</LanguageStandard> |
||||
<AdditionalIncludeDirectories>C:\Users\sigon\source\repos\Example\Example\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories> |
||||
</ClCompile> |
||||
<Link> |
||||
<SubSystem>Console</SubSystem> |
||||
<EnableCOMDATFolding>true</EnableCOMDATFolding> |
||||
<OptimizeReferences>true</OptimizeReferences> |
||||
<GenerateDebugInformation>true</GenerateDebugInformation> |
||||
<AdditionalLibraryDirectories>C:\Users\sigon\source\repos\Example\Example\libraries;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories> |
||||
</Link> |
||||
</ItemDefinitionGroup> |
||||
<ItemGroup> |
||||
<ClInclude Include="miniaudio.h" /> |
||||
<ClInclude Include="olcPGEX_Graphics3D.h" /> |
||||
<ClInclude Include="olcPGEX_MiniAudio.h" /> |
||||
<ClInclude Include="olcPGEX_QuickGUI.h" /> |
||||
<ClInclude Include="olcPGEX_TTF.h" /> |
||||
<ClInclude Include="olcSoundWaveEngine.h" /> |
||||
<ClInclude Include="olcSoundWaveEngine_pause.h" /> |
||||
<ClInclude Include="olcUTIL_DataFile.h" /> |
||||
<ClInclude Include="olcUTIL_Geometry2D.h" /> |
||||
<ClInclude Include="safemap.h" /> |
||||
<ClInclude Include="src\olcPixelGameEngine.h" /> |
||||
<ClInclude Include="vec2d.h" /> |
||||
</ItemGroup> |
||||
<ItemGroup> |
||||
<ClCompile Include="main.cpp" /> |
||||
<ClCompile Include="test2.cpp" /> |
||||
</ItemGroup> |
||||
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" /> |
||||
<ImportGroup Label="ExtensionTargets"> |
||||
</ImportGroup> |
||||
</Project> |
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,76 @@ |
||||
Monsters |
||||
{ |
||||
GREEN_SLIME = 4, 0.4, TEST |
||||
GREEN_SLIME |
||||
{ |
||||
Name = Green Slime |
||||
Health = 10 |
||||
Attack = 5 |
||||
|
||||
CollisionDmg = 5 |
||||
|
||||
MoveSpd = 110 |
||||
Size = 80 |
||||
|
||||
Strategy = RUN_TOWARDS |
||||
|
||||
ANIMATION[0] = TEST |
||||
} |
||||
BLUE_SLIME |
||||
{ |
||||
Name = Blue Slime |
||||
Health = 30 |
||||
Attack = 10 |
||||
|
||||
CollisionDmg = 0 |
||||
|
||||
MoveSpd = 80 |
||||
Size = 100 |
||||
|
||||
Strategy = SHOOT_AFAR |
||||
} |
||||
RED_SLIME |
||||
{ |
||||
Name = Red Slime |
||||
Health = 25 |
||||
Attack = 10 |
||||
|
||||
CollisionDmg = 10 |
||||
|
||||
MoveSpd = 95 |
||||
Size = 120 |
||||
|
||||
Strategy = RUN_TOWARDS |
||||
} |
||||
YELLOW_SLIME |
||||
{ |
||||
Name = Yellow Slime |
||||
Health = 175 |
||||
Attack = 10 |
||||
|
||||
CollisionDmg = 15 |
||||
|
||||
MoveSpd = 40 |
||||
Size = 160 |
||||
|
||||
Strategy = RUN_TOWARDS |
||||
} |
||||
FLOWER_TURRET |
||||
{ |
||||
Name = Flower Turret |
||||
Health = 40 |
||||
Attack = 10 |
||||
|
||||
CollisionDmg = 0 |
||||
|
||||
MoveSpd = 0 |
||||
Size = 100 |
||||
|
||||
Strategy = TURRET |
||||
} |
||||
|
||||
|
||||
TEST[0]=4 |
||||
TEST[1]=6 |
||||
TEST[2]=8 |
||||
} |
||||
|
After Width: | Height: | Size: 2.7 MiB |
|
After Width: | Height: | Size: 715 KiB |
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
@ -0,0 +1,10 @@ |
||||
# Exported from Wings 3D 2.2.9 |
||||
newmtl default |
||||
Ns 19.999999999999996 |
||||
d 1.0 |
||||
illum 2 |
||||
Kd 0.7898538076923077 0.8133333333333334 0.6940444444444445 |
||||
Ka 0.0 0.0 0.0 |
||||
Ks 0.1689853807692308 0.17133333333333334 0.15940444444444446 |
||||
Ke 0.0 0.0 0.0 |
||||
|
||||
|
After Width: | Height: | Size: 31 KiB |
Binary file not shown.
@ -0,0 +1,51 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftconfig.h |
||||
* |
||||
* ANSI-specific configuration file (specification only). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This header file contains a number of macro definitions that are used by |
||||
* the rest of the engine. Most of the macros here are automatically |
||||
* determined at compile time, and you should not need to change it to port |
||||
* FreeType, except to compile the library with a non-ANSI compiler. |
||||
* |
||||
* Note however that if some specific modifications are needed, we advise |
||||
* you to place a modified copy in your build directory. |
||||
* |
||||
* The build directory is usually `builds/<system>`, and contains |
||||
* system-specific files that are always included first when building the |
||||
* library. |
||||
* |
||||
* This ANSI version should stay in `include/config/`. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef FTCONFIG_H_ |
||||
#define FTCONFIG_H_ |
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_OPTIONS_H |
||||
#include FT_CONFIG_STANDARD_LIBRARY_H |
||||
|
||||
#include <freetype/config/integer-types.h> |
||||
#include <freetype/config/public-macros.h> |
||||
#include <freetype/config/mac-support.h> |
||||
|
||||
#endif /* FTCONFIG_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,836 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftheader.h |
||||
* |
||||
* Build macros of the FreeType 2 library. |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef FTHEADER_H_ |
||||
#define FTHEADER_H_ |
||||
|
||||
|
||||
/*@***********************************************************************/ |
||||
/* */ |
||||
/* <Macro> */ |
||||
/* FT_BEGIN_HEADER */ |
||||
/* */ |
||||
/* <Description> */ |
||||
/* This macro is used in association with @FT_END_HEADER in header */ |
||||
/* files to ensure that the declarations within are properly */ |
||||
/* encapsulated in an `extern "C" { .. }` block when included from a */ |
||||
/* C++ compiler. */ |
||||
/* */ |
||||
#ifndef FT_BEGIN_HEADER |
||||
# ifdef __cplusplus |
||||
# define FT_BEGIN_HEADER extern "C" { |
||||
# else |
||||
# define FT_BEGIN_HEADER /* nothing */ |
||||
# endif |
||||
#endif |
||||
|
||||
|
||||
/*@***********************************************************************/ |
||||
/* */ |
||||
/* <Macro> */ |
||||
/* FT_END_HEADER */ |
||||
/* */ |
||||
/* <Description> */ |
||||
/* This macro is used in association with @FT_BEGIN_HEADER in header */ |
||||
/* files to ensure that the declarations within are properly */ |
||||
/* encapsulated in an `extern "C" { .. }` block when included from a */ |
||||
/* C++ compiler. */ |
||||
/* */ |
||||
#ifndef FT_END_HEADER |
||||
# ifdef __cplusplus |
||||
# define FT_END_HEADER } |
||||
# else |
||||
# define FT_END_HEADER /* nothing */ |
||||
# endif |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Aliases for the FreeType 2 public and configuration files. |
||||
* |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* header_file_macros |
||||
* |
||||
* @title: |
||||
* Header File Macros |
||||
* |
||||
* @abstract: |
||||
* Macro definitions used to `#include` specific header files. |
||||
* |
||||
* @description: |
||||
* In addition to the normal scheme of including header files like |
||||
* |
||||
* ``` |
||||
* #include <freetype/freetype.h> |
||||
* #include <freetype/ftmm.h> |
||||
* #include <freetype/ftglyph.h> |
||||
* ``` |
||||
* |
||||
* it is possible to used named macros instead. They can be used |
||||
* directly in `#include` statements as in |
||||
* |
||||
* ``` |
||||
* #include FT_FREETYPE_H |
||||
* #include FT_MULTIPLE_MASTERS_H |
||||
* #include FT_GLYPH_H |
||||
* ``` |
||||
* |
||||
* These macros were introduced to overcome the infamous 8.3~naming rule |
||||
* required by DOS (and `FT_MULTIPLE_MASTERS_H` is a lot more meaningful |
||||
* than `ftmm.h`). |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* configuration files */ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CONFIG_CONFIG_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* FreeType~2 configuration data. |
||||
* |
||||
*/ |
||||
#ifndef FT_CONFIG_CONFIG_H |
||||
#define FT_CONFIG_CONFIG_H <freetype/config/ftconfig.h> |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CONFIG_STANDARD_LIBRARY_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* FreeType~2 interface to the standard C library functions. |
||||
* |
||||
*/ |
||||
#ifndef FT_CONFIG_STANDARD_LIBRARY_H |
||||
#define FT_CONFIG_STANDARD_LIBRARY_H <freetype/config/ftstdlib.h> |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CONFIG_OPTIONS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* FreeType~2 project-specific configuration options. |
||||
* |
||||
*/ |
||||
#ifndef FT_CONFIG_OPTIONS_H |
||||
#define FT_CONFIG_OPTIONS_H <freetype/config/ftoption.h> |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CONFIG_MODULES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* list of FreeType~2 modules that are statically linked to new library |
||||
* instances in @FT_Init_FreeType. |
||||
* |
||||
*/ |
||||
#ifndef FT_CONFIG_MODULES_H |
||||
#define FT_CONFIG_MODULES_H <freetype/config/ftmodule.h> |
||||
#endif |
||||
|
||||
/* */ |
||||
|
||||
/* public headers */ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FREETYPE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* base FreeType~2 API. |
||||
* |
||||
*/ |
||||
#define FT_FREETYPE_H <freetype/freetype.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ERRORS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* list of FreeType~2 error codes (and messages). |
||||
* |
||||
* It is included by @FT_FREETYPE_H. |
||||
* |
||||
*/ |
||||
#define FT_ERRORS_H <freetype/fterrors.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_MODULE_ERRORS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* list of FreeType~2 module error offsets (and messages). |
||||
* |
||||
*/ |
||||
#define FT_MODULE_ERRORS_H <freetype/ftmoderr.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_SYSTEM_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 interface to low-level operations (i.e., memory management |
||||
* and stream i/o). |
||||
* |
||||
* It is included by @FT_FREETYPE_H. |
||||
* |
||||
*/ |
||||
#define FT_SYSTEM_H <freetype/ftsystem.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_IMAGE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing type |
||||
* definitions related to glyph images (i.e., bitmaps, outlines, |
||||
* scan-converter parameters). |
||||
* |
||||
* It is included by @FT_FREETYPE_H. |
||||
* |
||||
*/ |
||||
#define FT_IMAGE_H <freetype/ftimage.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TYPES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* basic data types defined by FreeType~2. |
||||
* |
||||
* It is included by @FT_FREETYPE_H. |
||||
* |
||||
*/ |
||||
#define FT_TYPES_H <freetype/fttypes.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_LIST_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* list management API of FreeType~2. |
||||
* |
||||
* (Most applications will never need to include this file.) |
||||
* |
||||
*/ |
||||
#define FT_LIST_H <freetype/ftlist.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_OUTLINE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* scalable outline management API of FreeType~2. |
||||
* |
||||
*/ |
||||
#define FT_OUTLINE_H <freetype/ftoutln.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_SIZES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* API which manages multiple @FT_Size objects per face. |
||||
* |
||||
*/ |
||||
#define FT_SIZES_H <freetype/ftsizes.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_MODULE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* module management API of FreeType~2. |
||||
* |
||||
*/ |
||||
#define FT_MODULE_H <freetype/ftmodapi.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_RENDER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* renderer module management API of FreeType~2. |
||||
* |
||||
*/ |
||||
#define FT_RENDER_H <freetype/ftrender.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_DRIVER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* structures and macros related to the driver modules. |
||||
* |
||||
*/ |
||||
#define FT_DRIVER_H <freetype/ftdriver.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_AUTOHINTER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* structures and macros related to the auto-hinting module. |
||||
* |
||||
* Deprecated since version~2.9; use @FT_DRIVER_H instead. |
||||
* |
||||
*/ |
||||
#define FT_AUTOHINTER_H FT_DRIVER_H |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CFF_DRIVER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* structures and macros related to the CFF driver module. |
||||
* |
||||
* Deprecated since version~2.9; use @FT_DRIVER_H instead. |
||||
* |
||||
*/ |
||||
#define FT_CFF_DRIVER_H FT_DRIVER_H |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TRUETYPE_DRIVER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* structures and macros related to the TrueType driver module. |
||||
* |
||||
* Deprecated since version~2.9; use @FT_DRIVER_H instead. |
||||
* |
||||
*/ |
||||
#define FT_TRUETYPE_DRIVER_H FT_DRIVER_H |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_PCF_DRIVER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing |
||||
* structures and macros related to the PCF driver module. |
||||
* |
||||
* Deprecated since version~2.9; use @FT_DRIVER_H instead. |
||||
* |
||||
*/ |
||||
#define FT_PCF_DRIVER_H FT_DRIVER_H |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TYPE1_TABLES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* types and API specific to the Type~1 format. |
||||
* |
||||
*/ |
||||
#define FT_TYPE1_TABLES_H <freetype/t1tables.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TRUETYPE_IDS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* enumeration values which identify name strings, languages, encodings, |
||||
* etc. This file really contains a _large_ set of constant macro |
||||
* definitions, taken from the TrueType and OpenType specifications. |
||||
* |
||||
*/ |
||||
#define FT_TRUETYPE_IDS_H <freetype/ttnameid.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TRUETYPE_TABLES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* types and API specific to the TrueType (as well as OpenType) format. |
||||
* |
||||
*/ |
||||
#define FT_TRUETYPE_TABLES_H <freetype/tttables.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TRUETYPE_TAGS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of TrueType four-byte 'tags' which identify blocks in |
||||
* SFNT-based font formats (i.e., TrueType and OpenType). |
||||
* |
||||
*/ |
||||
#define FT_TRUETYPE_TAGS_H <freetype/tttags.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_BDF_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which accesses BDF-specific strings from a face. |
||||
* |
||||
*/ |
||||
#define FT_BDF_H <freetype/ftbdf.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CID_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which access CID font information from a face. |
||||
* |
||||
*/ |
||||
#define FT_CID_H <freetype/ftcid.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_GZIP_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which supports gzip-compressed files. |
||||
* |
||||
*/ |
||||
#define FT_GZIP_H <freetype/ftgzip.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_LZW_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which supports LZW-compressed files. |
||||
* |
||||
*/ |
||||
#define FT_LZW_H <freetype/ftlzw.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_BZIP2_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which supports bzip2-compressed files. |
||||
* |
||||
*/ |
||||
#define FT_BZIP2_H <freetype/ftbzip2.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_WINFONTS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* definitions of an API which supports Windows FNT files. |
||||
* |
||||
*/ |
||||
#define FT_WINFONTS_H <freetype/ftwinfnt.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_GLYPH_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* API of the optional glyph management component. |
||||
* |
||||
*/ |
||||
#define FT_GLYPH_H <freetype/ftglyph.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_BITMAP_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* API of the optional bitmap conversion component. |
||||
* |
||||
*/ |
||||
#define FT_BITMAP_H <freetype/ftbitmap.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_BBOX_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* API of the optional exact bounding box computation routines. |
||||
* |
||||
*/ |
||||
#define FT_BBOX_H <freetype/ftbbox.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_CACHE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* API of the optional FreeType~2 cache sub-system. |
||||
* |
||||
*/ |
||||
#define FT_CACHE_H <freetype/ftcache.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_MAC_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* Macintosh-specific FreeType~2 API. The latter is used to access fonts |
||||
* embedded in resource forks. |
||||
* |
||||
* This header file must be explicitly included by client applications |
||||
* compiled on the Mac (note that the base API still works though). |
||||
* |
||||
*/ |
||||
#define FT_MAC_H <freetype/ftmac.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_MULTIPLE_MASTERS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* optional multiple-masters management API of FreeType~2. |
||||
* |
||||
*/ |
||||
#define FT_MULTIPLE_MASTERS_H <freetype/ftmm.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_SFNT_NAMES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* optional FreeType~2 API which accesses embedded 'name' strings in |
||||
* SFNT-based font formats (i.e., TrueType and OpenType). |
||||
* |
||||
*/ |
||||
#define FT_SFNT_NAMES_H <freetype/ftsnames.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_OPENTYPE_VALIDATE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* optional FreeType~2 API which validates OpenType tables ('BASE', |
||||
* 'GDEF', 'GPOS', 'GSUB', 'JSTF'). |
||||
* |
||||
*/ |
||||
#define FT_OPENTYPE_VALIDATE_H <freetype/ftotval.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_GX_VALIDATE_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* optional FreeType~2 API which validates TrueTypeGX/AAT tables ('feat', |
||||
* 'mort', 'morx', 'bsln', 'just', 'kern', 'opbd', 'trak', 'prop'). |
||||
* |
||||
*/ |
||||
#define FT_GX_VALIDATE_H <freetype/ftgxval.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_PFR_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which accesses PFR-specific data. |
||||
* |
||||
*/ |
||||
#define FT_PFR_H <freetype/ftpfr.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_STROKER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which provides functions to stroke outline paths. |
||||
*/ |
||||
#define FT_STROKER_H <freetype/ftstroke.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_SYNTHESIS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which performs artificial obliquing and emboldening. |
||||
*/ |
||||
#define FT_SYNTHESIS_H <freetype/ftsynth.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FONT_FORMATS_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which provides functions specific to font formats. |
||||
*/ |
||||
#define FT_FONT_FORMATS_H <freetype/ftfntfmt.h> |
||||
|
||||
/* deprecated */ |
||||
#define FT_XFREE86_H FT_FONT_FORMATS_H |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_TRIGONOMETRY_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which performs trigonometric computations (e.g., |
||||
* cosines and arc tangents). |
||||
*/ |
||||
#define FT_TRIGONOMETRY_H <freetype/fttrigon.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_LCD_FILTER_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which performs color filtering for subpixel rendering. |
||||
*/ |
||||
#define FT_LCD_FILTER_H <freetype/ftlcdfil.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_INCREMENTAL_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which performs incremental glyph loading. |
||||
*/ |
||||
#define FT_INCREMENTAL_H <freetype/ftincrem.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_GASP_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which returns entries from the TrueType GASP table. |
||||
*/ |
||||
#define FT_GASP_H <freetype/ftgasp.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ADVANCES_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which returns individual and ranged glyph advances. |
||||
*/ |
||||
#define FT_ADVANCES_H <freetype/ftadvanc.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_COLOR_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which handles the OpenType 'CPAL' table. |
||||
*/ |
||||
#define FT_COLOR_H <freetype/ftcolor.h> |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_OTSVG_H |
||||
* |
||||
* @description: |
||||
* A macro used in `#include` statements to name the file containing the |
||||
* FreeType~2 API which handles the OpenType 'SVG~' glyphs. |
||||
*/ |
||||
#define FT_OTSVG_H <freetype/otsvg.h> |
||||
|
||||
|
||||
/* */ |
||||
|
||||
/* These header files don't need to be included by the user. */ |
||||
#define FT_ERROR_DEFINITIONS_H <freetype/fterrdef.h> |
||||
#define FT_PARAMETER_TAGS_H <freetype/ftparams.h> |
||||
|
||||
/* Deprecated macros. */ |
||||
#define FT_UNPATENTED_HINTING_H <freetype/ftparams.h> |
||||
#define FT_TRUETYPE_UNPATENTED_H <freetype/ftparams.h> |
||||
|
||||
/* `FT_CACHE_H` is the only header file needed for the cache subsystem. */ |
||||
#define FT_CACHE_IMAGE_H FT_CACHE_H |
||||
#define FT_CACHE_SMALL_BITMAPS_H FT_CACHE_H |
||||
#define FT_CACHE_CHARMAP_H FT_CACHE_H |
||||
|
||||
/* The internals of the cache sub-system are no longer exposed. We */ |
||||
/* default to `FT_CACHE_H` at the moment just in case, but we know */ |
||||
/* of no rogue client that uses them. */ |
||||
/* */ |
||||
#define FT_CACHE_MANAGER_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_MRU_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_MANAGER_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_CACHE_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_GLYPH_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_IMAGE_H FT_CACHE_H |
||||
#define FT_CACHE_INTERNAL_SBITS_H FT_CACHE_H |
||||
|
||||
/* TODO(david): Move this section below to a different header */ |
||||
#ifdef FT2_BUILD_LIBRARY |
||||
#if defined( _MSC_VER ) /* Visual C++ (and Intel C++) */ |
||||
|
||||
/* We disable the warning `conditional expression is constant' here */ |
||||
/* in order to compile cleanly with the maximum level of warnings. */ |
||||
/* In particular, the warning complains about stuff like `while(0)' */ |
||||
/* which is very useful in macro definitions. There is no benefit */ |
||||
/* in having it enabled. */ |
||||
#pragma warning( disable : 4127 ) |
||||
|
||||
#endif /* _MSC_VER */ |
||||
#endif /* FT2_BUILD_LIBRARY */ |
||||
|
||||
#endif /* FTHEADER_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,33 @@ |
||||
/*
|
||||
* This file registers the FreeType modules compiled into the library. |
||||
* |
||||
* If you use GNU make, this file IS NOT USED! Instead, it is created in |
||||
* the objects directory (normally `<topdir>/objs/`) based on information |
||||
* from `<topdir>/modules.cfg`. |
||||
* |
||||
* Please read `docs/INSTALL.ANY` and `docs/CUSTOMIZE` how to compile |
||||
* FreeType without GNU make. |
||||
* |
||||
*/ |
||||
|
||||
FT_USE_MODULE( FT_Module_Class, autofit_module_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, tt_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, t1_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, cff_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, t1cid_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, pfr_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, t42_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, winfnt_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, pcf_driver_class ) |
||||
FT_USE_MODULE( FT_Driver_ClassRec, bdf_driver_class ) |
||||
FT_USE_MODULE( FT_Module_Class, psaux_module_class ) |
||||
FT_USE_MODULE( FT_Module_Class, psnames_module_class ) |
||||
FT_USE_MODULE( FT_Module_Class, pshinter_module_class ) |
||||
FT_USE_MODULE( FT_Module_Class, sfnt_module_class ) |
||||
FT_USE_MODULE( FT_Renderer_Class, ft_smooth_renderer_class ) |
||||
FT_USE_MODULE( FT_Renderer_Class, ft_raster1_renderer_class ) |
||||
FT_USE_MODULE( FT_Renderer_Class, ft_sdf_renderer_class ) |
||||
FT_USE_MODULE( FT_Renderer_Class, ft_bitmap_sdf_renderer_class ) |
||||
FT_USE_MODULE( FT_Renderer_Class, ft_svg_renderer_class ) |
||||
|
||||
/* EOF */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,185 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftstdlib.h |
||||
* |
||||
* ANSI-specific library and header configuration file (specification |
||||
* only). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This file is used to group all `#includes` to the ANSI~C library that |
||||
* FreeType normally requires. It also defines macros to rename the |
||||
* standard functions within the FreeType source code. |
||||
* |
||||
* Load a file which defines `FTSTDLIB_H_` before this one to override it. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSTDLIB_H_ |
||||
#define FTSTDLIB_H_ |
||||
|
||||
|
||||
#include <stddef.h> |
||||
|
||||
#define ft_ptrdiff_t ptrdiff_t |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* integer limits |
||||
* |
||||
* `UINT_MAX` and `ULONG_MAX` are used to automatically compute the size of |
||||
* `int` and `long` in bytes at compile-time. So far, this works for all |
||||
* platforms the library has been tested on. We also check `ULLONG_MAX` |
||||
* to see whether we can use 64-bit `long long` later on. |
||||
* |
||||
* Note that on the extremely rare platforms that do not provide integer |
||||
* types that are _exactly_ 16 and 32~bits wide (e.g., some old Crays where |
||||
* `int` is 36~bits), we do not make any guarantee about the correct |
||||
* behaviour of FreeType~2 with all fonts. |
||||
* |
||||
* In these cases, `ftconfig.h` will refuse to compile anyway with a |
||||
* message like 'couldn't find 32-bit type' or something similar. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <limits.h> |
||||
|
||||
#define FT_CHAR_BIT CHAR_BIT |
||||
#define FT_USHORT_MAX USHRT_MAX |
||||
#define FT_INT_MAX INT_MAX |
||||
#define FT_INT_MIN INT_MIN |
||||
#define FT_UINT_MAX UINT_MAX |
||||
#define FT_LONG_MIN LONG_MIN |
||||
#define FT_LONG_MAX LONG_MAX |
||||
#define FT_ULONG_MAX ULONG_MAX |
||||
#ifdef LLONG_MAX |
||||
#define FT_LLONG_MAX LLONG_MAX |
||||
#endif |
||||
#ifdef LLONG_MIN |
||||
#define FT_LLONG_MIN LLONG_MIN |
||||
#endif |
||||
#ifdef ULLONG_MAX |
||||
#define FT_ULLONG_MAX ULLONG_MAX |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* character and string processing |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <string.h> |
||||
|
||||
#define ft_memchr memchr |
||||
#define ft_memcmp memcmp |
||||
#define ft_memcpy memcpy |
||||
#define ft_memmove memmove |
||||
#define ft_memset memset |
||||
#define ft_strcat strcat |
||||
#define ft_strcmp strcmp |
||||
#define ft_strcpy strcpy |
||||
#define ft_strlen strlen |
||||
#define ft_strncmp strncmp |
||||
#define ft_strncpy strncpy |
||||
#define ft_strrchr strrchr |
||||
#define ft_strstr strstr |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* file handling |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <stdio.h> |
||||
|
||||
#define FT_FILE FILE |
||||
#define ft_fclose fclose |
||||
#define ft_fopen fopen |
||||
#define ft_fread fread |
||||
#define ft_fseek fseek |
||||
#define ft_ftell ftell |
||||
#define ft_snprintf snprintf |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* sorting |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <stdlib.h> |
||||
|
||||
#define ft_qsort qsort |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* memory allocation |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#define ft_scalloc calloc |
||||
#define ft_sfree free |
||||
#define ft_smalloc malloc |
||||
#define ft_srealloc realloc |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* miscellaneous |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#define ft_strtol strtol |
||||
#define ft_getenv getenv |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* execution control |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <setjmp.h> |
||||
|
||||
#define ft_jmp_buf jmp_buf /* note: this cannot be a typedef since */ |
||||
/* `jmp_buf` is defined as a macro */ |
||||
/* on certain platforms */ |
||||
|
||||
#define ft_longjmp longjmp |
||||
#define ft_setjmp( b ) setjmp( *(ft_jmp_buf*) &(b) ) /* same thing here */ |
||||
|
||||
|
||||
/* The following is only used for debugging purposes, i.e., if */ |
||||
/* `FT_DEBUG_LEVEL_ERROR` or `FT_DEBUG_LEVEL_TRACE` are defined. */ |
||||
|
||||
#include <stdarg.h> |
||||
|
||||
|
||||
#endif /* FTSTDLIB_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,250 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/integer-types.h |
||||
* |
||||
* FreeType integer types definitions. |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_INTEGER_TYPES_H_ |
||||
#define FREETYPE_CONFIG_INTEGER_TYPES_H_ |
||||
|
||||
/* There are systems (like the Texas Instruments 'C54x) where a `char` */ |
||||
/* has 16~bits. ANSI~C says that `sizeof(char)` is always~1. Since an */ |
||||
/* `int` has 16~bits also for this system, `sizeof(int)` gives~1 which */ |
||||
/* is probably unexpected. */ |
||||
/* */ |
||||
/* `CHAR_BIT` (defined in `limits.h`) gives the number of bits in a */ |
||||
/* `char` type. */ |
||||
|
||||
#ifndef FT_CHAR_BIT |
||||
#define FT_CHAR_BIT CHAR_BIT |
||||
#endif |
||||
|
||||
#ifndef FT_SIZEOF_INT |
||||
|
||||
/* The size of an `int` type. */ |
||||
#if FT_UINT_MAX == 0xFFFFUL |
||||
#define FT_SIZEOF_INT ( 16 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX > 0xFFFFFFFFUL && FT_UINT_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `int' type!" |
||||
#endif |
||||
|
||||
#endif /* !defined(FT_SIZEOF_INT) */ |
||||
|
||||
#ifndef FT_SIZEOF_LONG |
||||
|
||||
/* The size of a `long` type. A five-byte `long` (as used e.g. on the */ |
||||
/* DM642) is recognized but avoided. */ |
||||
#if FT_ULONG_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `long' type!" |
||||
#endif |
||||
|
||||
#endif /* !defined(FT_SIZEOF_LONG) */ |
||||
|
||||
#ifndef FT_SIZEOF_LONG_LONG |
||||
|
||||
/* The size of a `long long` type if available */ |
||||
#if defined( FT_ULLONG_MAX ) && FT_ULLONG_MAX >= 0xFFFFFFFFFFFFFFFFULL |
||||
#define FT_SIZEOF_LONG_LONG ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#define FT_SIZEOF_LONG_LONG 0 |
||||
#endif |
||||
|
||||
#endif /* !defined(FT_SIZEOF_LONG_LONG) */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* basic_types |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit signed integer type. |
||||
*/ |
||||
typedef signed short FT_Int16; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit unsigned integer type. |
||||
*/ |
||||
typedef unsigned short FT_UInt16; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
/* this #if 0 ... #endif clause is for documentation purposes */ |
||||
#if 0 |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int32 |
||||
* |
||||
* @description: |
||||
* A typedef for a 32bit signed integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef signed XXX FT_Int32; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt32 |
||||
* |
||||
* A typedef for a 32bit unsigned integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef unsigned XXX FT_UInt32; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int64 |
||||
* |
||||
* A typedef for a 64bit signed integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef signed XXX FT_Int64; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt64 |
||||
* |
||||
* A typedef for a 64bit unsigned integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef unsigned XXX FT_UInt64; |
||||
|
||||
/* */ |
||||
|
||||
#endif |
||||
|
||||
#if FT_SIZEOF_INT == ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef signed int FT_Int32; |
||||
typedef unsigned int FT_UInt32; |
||||
|
||||
#elif FT_SIZEOF_LONG == ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef signed long FT_Int32; |
||||
typedef unsigned long FT_UInt32; |
||||
|
||||
#else |
||||
#error "no 32bit type found -- please check your configuration files" |
||||
#endif |
||||
|
||||
|
||||
/* look up an integer type that is at least 32~bits */ |
||||
#if FT_SIZEOF_INT >= ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef int FT_Fast; |
||||
typedef unsigned int FT_UFast; |
||||
|
||||
#elif FT_SIZEOF_LONG >= ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef long FT_Fast; |
||||
typedef unsigned long FT_UFast; |
||||
|
||||
#endif |
||||
|
||||
|
||||
/* determine whether we have a 64-bit integer type */ |
||||
#if FT_SIZEOF_LONG == ( 64 / FT_CHAR_BIT ) |
||||
|
||||
#define FT_INT64 long |
||||
#define FT_UINT64 unsigned long |
||||
|
||||
#elif FT_SIZEOF_LONG_LONG >= ( 64 / FT_CHAR_BIT ) |
||||
|
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* A 64-bit data type may create compilation problems if you compile in |
||||
* strict ANSI mode. To avoid them, we disable other 64-bit data types if |
||||
* `__STDC__` is defined. You can however ignore this rule by defining the |
||||
* `FT_CONFIG_OPTION_FORCE_INT64` configuration macro. |
||||
*/ |
||||
#elif !defined( __STDC__ ) || defined( FT_CONFIG_OPTION_FORCE_INT64 ) |
||||
|
||||
#if defined( _MSC_VER ) && _MSC_VER >= 900 /* Visual C++ (and Intel C++) */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __BORLANDC__ ) /* Borland C++ */ |
||||
|
||||
/* XXXX: We should probably check the value of `__BORLANDC__` in order */ |
||||
/* to test the compiler version. */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __WATCOMC__ ) && __WATCOMC__ >= 1100 /* Watcom C++ */ |
||||
|
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( __MWERKS__ ) /* Metrowerks CodeWarrior */ |
||||
|
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( __GNUC__ ) |
||||
|
||||
/* GCC provides the `long long` type */ |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#endif /* !__STDC__ */ |
||||
|
||||
#endif /* FT_SIZEOF_LONG == (64 / FT_CHAR_BIT) */ |
||||
|
||||
#ifdef FT_INT64 |
||||
typedef FT_INT64 FT_Int64; |
||||
typedef FT_UINT64 FT_UInt64; |
||||
#endif |
||||
|
||||
|
||||
#endif /* FREETYPE_CONFIG_INTEGER_TYPES_H_ */ |
||||
@ -0,0 +1,49 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/mac-support.h |
||||
* |
||||
* Mac/OS X support configuration header. |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_MAC_SUPPORT_H_ |
||||
#define FREETYPE_CONFIG_MAC_SUPPORT_H_ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Mac support |
||||
* |
||||
* This is the only necessary change, so it is defined here instead |
||||
* providing a new configuration file. |
||||
*/ |
||||
#if defined( __APPLE__ ) || ( defined( __MWERKS__ ) && defined( macintosh ) ) |
||||
/* No Carbon frameworks for 64bit 10.4.x. */ |
||||
/* `AvailabilityMacros.h` is available since Mac OS X 10.2, */ |
||||
/* so guess the system version by maximum errno before inclusion. */ |
||||
#include <errno.h> |
||||
#ifdef ECANCELED /* defined since 10.2 */ |
||||
#include "AvailabilityMacros.h" |
||||
#endif |
||||
#if defined( __LP64__ ) && \ |
||||
( MAC_OS_X_VERSION_MIN_REQUIRED <= MAC_OS_X_VERSION_10_4 ) |
||||
#undef FT_MACINTOSH |
||||
#endif |
||||
|
||||
#elif defined( __SC__ ) || defined( __MRC__ ) |
||||
/* Classic MacOS compilers */ |
||||
#include "ConditionalMacros.h" |
||||
#if TARGET_OS_MAC |
||||
#define FT_MACINTOSH 1 |
||||
#endif |
||||
|
||||
#endif /* Mac support */ |
||||
|
||||
#endif /* FREETYPE_CONFIG_MAC_SUPPORT_H_ */ |
||||
@ -0,0 +1,138 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/public-macros.h |
||||
* |
||||
* Define a set of compiler macros used in public FreeType headers. |
||||
* |
||||
* Copyright (C) 2020-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
/*
|
||||
* The definitions in this file are used by the public FreeType headers |
||||
* and thus should be considered part of the public API. |
||||
* |
||||
* Other compiler-specific macro definitions that are not exposed by the |
||||
* FreeType API should go into |
||||
* `include/freetype/internal/compiler-macros.h` instead. |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_PUBLIC_MACROS_H_ |
||||
#define FREETYPE_CONFIG_PUBLIC_MACROS_H_ |
||||
|
||||
/*
|
||||
* `FT_BEGIN_HEADER` and `FT_END_HEADER` might have already been defined |
||||
* by `freetype/config/ftheader.h`, but we don't want to include this |
||||
* header here, so redefine the macros here only when needed. Their |
||||
* definition is very stable, so keeping them in sync with the ones in the |
||||
* header should not be a maintenance issue. |
||||
*/ |
||||
#ifndef FT_BEGIN_HEADER |
||||
#ifdef __cplusplus |
||||
#define FT_BEGIN_HEADER extern "C" { |
||||
#else |
||||
#define FT_BEGIN_HEADER /* empty */ |
||||
#endif |
||||
#endif /* FT_BEGIN_HEADER */ |
||||
|
||||
#ifndef FT_END_HEADER |
||||
#ifdef __cplusplus |
||||
#define FT_END_HEADER } |
||||
#else |
||||
#define FT_END_HEADER /* empty */ |
||||
#endif |
||||
#endif /* FT_END_HEADER */ |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/*
|
||||
* Mark a function declaration as public. This ensures it will be |
||||
* properly exported to client code. Place this before a function |
||||
* declaration. |
||||
* |
||||
* NOTE: This macro should be considered an internal implementation |
||||
* detail, and not part of the FreeType API. It is only defined here |
||||
* because it is needed by `FT_EXPORT`. |
||||
*/ |
||||
|
||||
/* Visual C, mingw */ |
||||
#if defined( _WIN32 ) |
||||
|
||||
#if defined( FT2_BUILD_LIBRARY ) && defined( DLL_EXPORT ) |
||||
#define FT_PUBLIC_FUNCTION_ATTRIBUTE __declspec( dllexport ) |
||||
#elif defined( DLL_IMPORT ) |
||||
#define FT_PUBLIC_FUNCTION_ATTRIBUTE __declspec( dllimport ) |
||||
#endif |
||||
|
||||
/* gcc, clang */ |
||||
#elif ( defined( __GNUC__ ) && __GNUC__ >= 4 ) || defined( __clang__ ) |
||||
#define FT_PUBLIC_FUNCTION_ATTRIBUTE \ |
||||
__attribute__(( visibility( "default" ) )) |
||||
|
||||
/* Sun */ |
||||
#elif defined( __SUNPRO_C ) && __SUNPRO_C >= 0x550 |
||||
#define FT_PUBLIC_FUNCTION_ATTRIBUTE __global |
||||
#endif |
||||
|
||||
|
||||
#ifndef FT_PUBLIC_FUNCTION_ATTRIBUTE |
||||
#define FT_PUBLIC_FUNCTION_ATTRIBUTE /* empty */ |
||||
#endif |
||||
|
||||
|
||||
/*
|
||||
* Define a public FreeType API function. This ensures it is properly |
||||
* exported or imported at build time. The macro parameter is the |
||||
* function's return type as in: |
||||
* |
||||
* FT_EXPORT( FT_Bool ) |
||||
* FT_Object_Method( FT_Object obj, |
||||
* ... ); |
||||
* |
||||
* NOTE: This requires that all `FT_EXPORT` uses are inside |
||||
* `FT_BEGIN_HEADER ... FT_END_HEADER` blocks. This guarantees that the |
||||
* functions are exported with C linkage, even when the header is included |
||||
* by a C++ source file. |
||||
*/ |
||||
#define FT_EXPORT( x ) FT_PUBLIC_FUNCTION_ATTRIBUTE extern x |
||||
|
||||
|
||||
/*
|
||||
* `FT_UNUSED` indicates that a given parameter is not used -- this is |
||||
* only used to get rid of unpleasant compiler warnings. |
||||
* |
||||
* Technically, this was not meant to be part of the public API, but some |
||||
* third-party code depends on it. |
||||
*/ |
||||
#ifndef FT_UNUSED |
||||
#define FT_UNUSED( arg ) ( (arg) = (arg) ) |
||||
#endif |
||||
|
||||
|
||||
/*
|
||||
* Support for casts in both C and C++. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
#define FT_STATIC_CAST( type, var ) static_cast<type>(var) |
||||
#define FT_REINTERPRET_CAST( type, var ) reinterpret_cast<type>(var) |
||||
|
||||
#define FT_STATIC_BYTE_CAST( type, var ) \ |
||||
static_cast<type>( static_cast<unsigned char>( var ) ) |
||||
#else |
||||
#define FT_STATIC_CAST( type, var ) (type)(var) |
||||
#define FT_REINTERPRET_CAST( type, var ) (type)(var) |
||||
|
||||
#define FT_STATIC_BYTE_CAST( type, var ) (type)(unsigned char)(var) |
||||
#endif |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FREETYPE_CONFIG_PUBLIC_MACROS_H_ */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,188 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftadvanc.h |
||||
* |
||||
* Quick computation of advance widths (specification only). |
||||
* |
||||
* Copyright (C) 2008-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTADVANC_H_ |
||||
#define FTADVANC_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* quick_advance |
||||
* |
||||
* @title: |
||||
* Quick retrieval of advance values |
||||
* |
||||
* @abstract: |
||||
* Retrieve horizontal and vertical advance values without processing |
||||
* glyph outlines, if possible. |
||||
* |
||||
* @description: |
||||
* This section contains functions to quickly extract advance values |
||||
* without handling glyph outlines, if possible. |
||||
* |
||||
* @order: |
||||
* FT_Get_Advance |
||||
* FT_Get_Advances |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_ADVANCE_FLAG_FAST_ONLY |
||||
* |
||||
* @description: |
||||
* A bit-flag to be OR-ed with the `flags` parameter of the |
||||
* @FT_Get_Advance and @FT_Get_Advances functions. |
||||
* |
||||
* If set, it indicates that you want these functions to fail if the |
||||
* corresponding hinting mode or font driver doesn't allow for very quick |
||||
* advance computation. |
||||
* |
||||
* Typically, glyphs that are either unscaled, unhinted, bitmapped, or |
||||
* light-hinted can have their advance width computed very quickly. |
||||
* |
||||
* Normal and bytecode hinted modes that require loading, scaling, and |
||||
* hinting of the glyph outline, are extremely slow by comparison. |
||||
*/ |
||||
#define FT_ADVANCE_FLAG_FAST_ONLY 0x20000000L |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Advance |
||||
* |
||||
* @description: |
||||
* Retrieve the advance value of a given glyph outline in an @FT_Face. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source @FT_Face handle. |
||||
* |
||||
* gindex :: |
||||
* The glyph index. |
||||
* |
||||
* load_flags :: |
||||
* A set of bit flags similar to those used when calling |
||||
* @FT_Load_Glyph, used to determine what kind of advances you need. |
||||
* |
||||
* @output: |
||||
* padvance :: |
||||
* The advance value. If scaling is performed (based on the value of |
||||
* `load_flags`), the advance value is in 16.16 format. Otherwise, it |
||||
* is in font units. |
||||
* |
||||
* If @FT_LOAD_VERTICAL_LAYOUT is set, this is the vertical advance |
||||
* corresponding to a vertical layout. Otherwise, it is the horizontal |
||||
* advance in a horizontal layout. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* This function may fail if you use @FT_ADVANCE_FLAG_FAST_ONLY and if |
||||
* the corresponding font backend doesn't have a quick way to retrieve |
||||
* the advances. |
||||
* |
||||
* A scaled advance is returned in 16.16 format but isn't transformed by |
||||
* the affine transformation specified by @FT_Set_Transform. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Advance( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int32 load_flags, |
||||
FT_Fixed *padvance ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Advances |
||||
* |
||||
* @description: |
||||
* Retrieve the advance values of several glyph outlines in an @FT_Face. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source @FT_Face handle. |
||||
* |
||||
* start :: |
||||
* The first glyph index. |
||||
* |
||||
* count :: |
||||
* The number of advance values you want to retrieve. |
||||
* |
||||
* load_flags :: |
||||
* A set of bit flags similar to those used when calling |
||||
* @FT_Load_Glyph. |
||||
* |
||||
* @output: |
||||
* padvance :: |
||||
* The advance values. This array, to be provided by the caller, must |
||||
* contain at least `count` elements. |
||||
* |
||||
* If scaling is performed (based on the value of `load_flags`), the |
||||
* advance values are in 16.16 format. Otherwise, they are in font |
||||
* units. |
||||
* |
||||
* If @FT_LOAD_VERTICAL_LAYOUT is set, these are the vertical advances |
||||
* corresponding to a vertical layout. Otherwise, they are the |
||||
* horizontal advances in a horizontal layout. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* This function may fail if you use @FT_ADVANCE_FLAG_FAST_ONLY and if |
||||
* the corresponding font backend doesn't have a quick way to retrieve |
||||
* the advances. |
||||
* |
||||
* Scaled advances are returned in 16.16 format but aren't transformed by |
||||
* the affine transformation specified by @FT_Set_Transform. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Advances( FT_Face face, |
||||
FT_UInt start, |
||||
FT_UInt count, |
||||
FT_Int32 load_flags, |
||||
FT_Fixed *padvances ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTADVANC_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,101 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftbbox.h |
||||
* |
||||
* FreeType exact bbox computation (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This component has a _single_ role: to compute exact outline bounding |
||||
* boxes. |
||||
* |
||||
* It is separated from the rest of the engine for various technical |
||||
* reasons. It may well be integrated in 'ftoutln' later. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTBBOX_H_ |
||||
#define FTBBOX_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* outline_processing |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Get_BBox |
||||
* |
||||
* @description: |
||||
* Compute the exact bounding box of an outline. This is slower than |
||||
* computing the control box. However, it uses an advanced algorithm |
||||
* that returns _very_ quickly when the two boxes coincide. Otherwise, |
||||
* the outline Bezier arcs are traversed to extract their extrema. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* A pointer to the source outline. |
||||
* |
||||
* @output: |
||||
* abbox :: |
||||
* The outline's exact bounding box. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If the font is tricky and the glyph has been loaded with |
||||
* @FT_LOAD_NO_SCALE, the resulting BBox is meaningless. To get |
||||
* reasonable values for the BBox it is necessary to load the glyph at a |
||||
* large ppem value (so that the hinting instructions can properly shift |
||||
* and scale the subglyphs), then extracting the BBox, which can be |
||||
* eventually converted back to font units. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Get_BBox( FT_Outline* outline, |
||||
FT_BBox *abbox ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTBBOX_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
|
||||
|
||||
/* Local Variables: */ |
||||
/* coding: utf-8 */ |
||||
/* End: */ |
||||
@ -0,0 +1,212 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftbdf.h |
||||
* |
||||
* FreeType API for accessing BDF-specific strings (specification). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTBDF_H_ |
||||
#define FTBDF_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* bdf_fonts |
||||
* |
||||
* @title: |
||||
* BDF and PCF Files |
||||
* |
||||
* @abstract: |
||||
* BDF and PCF specific API. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of functions specific to BDF and |
||||
* PCF fonts. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* BDF_PropertyType |
||||
* |
||||
* @description: |
||||
* A list of BDF property types. |
||||
* |
||||
* @values: |
||||
* BDF_PROPERTY_TYPE_NONE :: |
||||
* Value~0 is used to indicate a missing property. |
||||
* |
||||
* BDF_PROPERTY_TYPE_ATOM :: |
||||
* Property is a string atom. |
||||
* |
||||
* BDF_PROPERTY_TYPE_INTEGER :: |
||||
* Property is a 32-bit signed integer. |
||||
* |
||||
* BDF_PROPERTY_TYPE_CARDINAL :: |
||||
* Property is a 32-bit unsigned integer. |
||||
*/ |
||||
typedef enum BDF_PropertyType_ |
||||
{ |
||||
BDF_PROPERTY_TYPE_NONE = 0, |
||||
BDF_PROPERTY_TYPE_ATOM = 1, |
||||
BDF_PROPERTY_TYPE_INTEGER = 2, |
||||
BDF_PROPERTY_TYPE_CARDINAL = 3 |
||||
|
||||
} BDF_PropertyType; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* BDF_Property |
||||
* |
||||
* @description: |
||||
* A handle to a @BDF_PropertyRec structure to model a given BDF/PCF |
||||
* property. |
||||
*/ |
||||
typedef struct BDF_PropertyRec_* BDF_Property; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* BDF_PropertyRec |
||||
* |
||||
* @description: |
||||
* This structure models a given BDF/PCF property. |
||||
* |
||||
* @fields: |
||||
* type :: |
||||
* The property type. |
||||
* |
||||
* u.atom :: |
||||
* The atom string, if type is @BDF_PROPERTY_TYPE_ATOM. May be |
||||
* `NULL`, indicating an empty string. |
||||
* |
||||
* u.integer :: |
||||
* A signed integer, if type is @BDF_PROPERTY_TYPE_INTEGER. |
||||
* |
||||
* u.cardinal :: |
||||
* An unsigned integer, if type is @BDF_PROPERTY_TYPE_CARDINAL. |
||||
*/ |
||||
typedef struct BDF_PropertyRec_ |
||||
{ |
||||
BDF_PropertyType type; |
||||
union { |
||||
const char* atom; |
||||
FT_Int32 integer; |
||||
FT_UInt32 cardinal; |
||||
|
||||
} u; |
||||
|
||||
} BDF_PropertyRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_BDF_Charset_ID |
||||
* |
||||
* @description: |
||||
* Retrieve a BDF font character set identity, according to the BDF |
||||
* specification. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* @output: |
||||
* acharset_encoding :: |
||||
* Charset encoding, as a C~string, owned by the face. |
||||
* |
||||
* acharset_registry :: |
||||
* Charset registry, as a C~string, owned by the face. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with BDF faces, returning an error otherwise. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_BDF_Charset_ID( FT_Face face, |
||||
const char* *acharset_encoding, |
||||
const char* *acharset_registry ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_BDF_Property |
||||
* |
||||
* @description: |
||||
* Retrieve a BDF property from a BDF or PCF font file. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* name :: |
||||
* The property name. |
||||
* |
||||
* @output: |
||||
* aproperty :: |
||||
* The property. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function works with BDF _and_ PCF fonts. It returns an error |
||||
* otherwise. It also returns an error if the property is not in the |
||||
* font. |
||||
* |
||||
* A 'property' is a either key-value pair within the STARTPROPERTIES |
||||
* ... ENDPROPERTIES block of a BDF font or a key-value pair from the |
||||
* `info->props` array within a `FontRec` structure of a PCF font. |
||||
* |
||||
* Integer properties are always stored as 'signed' within PCF fonts; |
||||
* consequently, @BDF_PROPERTY_TYPE_CARDINAL is a possible return value |
||||
* for BDF fonts only. |
||||
* |
||||
* In case of error, `aproperty->type` is always set to |
||||
* @BDF_PROPERTY_TYPE_NONE. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_BDF_Property( FT_Face face, |
||||
const char* prop_name, |
||||
BDF_PropertyRec *aproperty ); |
||||
|
||||
/* */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTBDF_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,329 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftbitmap.h |
||||
* |
||||
* FreeType utility functions for bitmaps (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTBITMAP_H_ |
||||
#define FTBITMAP_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/ftcolor.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* bitmap_handling |
||||
* |
||||
* @title: |
||||
* Bitmap Handling |
||||
* |
||||
* @abstract: |
||||
* Handling FT_Bitmap objects. |
||||
* |
||||
* @description: |
||||
* This section contains functions for handling @FT_Bitmap objects, |
||||
* automatically adjusting the target's bitmap buffer size as needed. |
||||
* |
||||
* Note that none of the functions changes the bitmap's 'flow' (as |
||||
* indicated by the sign of the `pitch` field in @FT_Bitmap). |
||||
* |
||||
* To set the flow, assign an appropriate positive or negative value to |
||||
* the `pitch` field of the target @FT_Bitmap object after calling |
||||
* @FT_Bitmap_Init but before calling any of the other functions |
||||
* described here. |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Init |
||||
* |
||||
* @description: |
||||
* Initialize a pointer to an @FT_Bitmap structure. |
||||
* |
||||
* @inout: |
||||
* abitmap :: |
||||
* A pointer to the bitmap structure. |
||||
* |
||||
* @note: |
||||
* A deprecated name for the same function is `FT_Bitmap_New`. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Bitmap_Init( FT_Bitmap *abitmap ); |
||||
|
||||
|
||||
/* deprecated */ |
||||
FT_EXPORT( void ) |
||||
FT_Bitmap_New( FT_Bitmap *abitmap ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Copy |
||||
* |
||||
* @description: |
||||
* Copy a bitmap into another one. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* source :: |
||||
* A handle to the source bitmap. |
||||
* |
||||
* @output: |
||||
* target :: |
||||
* A handle to the target bitmap. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* `source->buffer` and `target->buffer` must neither be equal nor |
||||
* overlap. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Bitmap_Copy( FT_Library library, |
||||
const FT_Bitmap *source, |
||||
FT_Bitmap *target ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Embolden |
||||
* |
||||
* @description: |
||||
* Embolden a bitmap. The new bitmap will be about `xStrength` pixels |
||||
* wider and `yStrength` pixels higher. The left and bottom borders are |
||||
* kept unchanged. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* xStrength :: |
||||
* How strong the glyph is emboldened horizontally. Expressed in 26.6 |
||||
* pixel format. |
||||
* |
||||
* yStrength :: |
||||
* How strong the glyph is emboldened vertically. Expressed in 26.6 |
||||
* pixel format. |
||||
* |
||||
* @inout: |
||||
* bitmap :: |
||||
* A handle to the target bitmap. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The current implementation restricts `xStrength` to be less than or |
||||
* equal to~8 if bitmap is of pixel_mode @FT_PIXEL_MODE_MONO. |
||||
* |
||||
* If you want to embolden the bitmap owned by a @FT_GlyphSlotRec, you |
||||
* should call @FT_GlyphSlot_Own_Bitmap on the slot first. |
||||
* |
||||
* Bitmaps in @FT_PIXEL_MODE_GRAY2 and @FT_PIXEL_MODE_GRAY@ format are |
||||
* converted to @FT_PIXEL_MODE_GRAY format (i.e., 8bpp). |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Bitmap_Embolden( FT_Library library, |
||||
FT_Bitmap* bitmap, |
||||
FT_Pos xStrength, |
||||
FT_Pos yStrength ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Convert |
||||
* |
||||
* @description: |
||||
* Convert a bitmap object with depth 1bpp, 2bpp, 4bpp, 8bpp or 32bpp to |
||||
* a bitmap object with depth 8bpp, making the number of used bytes per |
||||
* line (a.k.a. the 'pitch') a multiple of `alignment`. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* source :: |
||||
* The source bitmap. |
||||
* |
||||
* alignment :: |
||||
* The pitch of the bitmap is a multiple of this argument. Common |
||||
* values are 1, 2, or 4. |
||||
* |
||||
* @output: |
||||
* target :: |
||||
* The target bitmap. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* It is possible to call @FT_Bitmap_Convert multiple times without |
||||
* calling @FT_Bitmap_Done (the memory is simply reallocated). |
||||
* |
||||
* Use @FT_Bitmap_Done to finally remove the bitmap object. |
||||
* |
||||
* The `library` argument is taken to have access to FreeType's memory |
||||
* handling functions. |
||||
* |
||||
* `source->buffer` and `target->buffer` must neither be equal nor |
||||
* overlap. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Bitmap_Convert( FT_Library library, |
||||
const FT_Bitmap *source, |
||||
FT_Bitmap *target, |
||||
FT_Int alignment ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Blend |
||||
* |
||||
* @description: |
||||
* Blend a bitmap onto another bitmap, using a given color. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* source :: |
||||
* The source bitmap, which can have any @FT_Pixel_Mode format. |
||||
* |
||||
* source_offset :: |
||||
* The offset vector to the upper left corner of the source bitmap in |
||||
* 26.6 pixel format. It should represent an integer offset; the |
||||
* function will set the lowest six bits to zero to enforce that. |
||||
* |
||||
* color :: |
||||
* The color used to draw `source` onto `target`. |
||||
* |
||||
* @inout: |
||||
* target :: |
||||
* A handle to an `FT_Bitmap` object. It should be either initialized |
||||
* as empty with a call to @FT_Bitmap_Init, or it should be of type |
||||
* @FT_PIXEL_MODE_BGRA. |
||||
* |
||||
* atarget_offset :: |
||||
* The offset vector to the upper left corner of the target bitmap in |
||||
* 26.6 pixel format. It should represent an integer offset; the |
||||
* function will set the lowest six bits to zero to enforce that. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function doesn't perform clipping. |
||||
* |
||||
* The bitmap in `target` gets allocated or reallocated as needed; the |
||||
* vector `atarget_offset` is updated accordingly. |
||||
* |
||||
* In case of allocation or reallocation, the bitmap's pitch is set to |
||||
* `4 * width`. Both `source` and `target` must have the same bitmap |
||||
* flow (as indicated by the sign of the `pitch` field). |
||||
* |
||||
* `source->buffer` and `target->buffer` must neither be equal nor |
||||
* overlap. |
||||
* |
||||
* @since: |
||||
* 2.10 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Bitmap_Blend( FT_Library library, |
||||
const FT_Bitmap* source, |
||||
const FT_Vector source_offset, |
||||
FT_Bitmap* target, |
||||
FT_Vector *atarget_offset, |
||||
FT_Color color ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_GlyphSlot_Own_Bitmap |
||||
* |
||||
* @description: |
||||
* Make sure that a glyph slot owns `slot->bitmap`. |
||||
* |
||||
* @input: |
||||
* slot :: |
||||
* The glyph slot. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function is to be used in combination with @FT_Bitmap_Embolden. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_GlyphSlot_Own_Bitmap( FT_GlyphSlot slot ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Bitmap_Done |
||||
* |
||||
* @description: |
||||
* Destroy a bitmap object initialized with @FT_Bitmap_Init. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* bitmap :: |
||||
* The bitmap object to be freed. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The `library` argument is taken to have access to FreeType's memory |
||||
* handling functions. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Bitmap_Done( FT_Library library, |
||||
FT_Bitmap *bitmap ); |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTBITMAP_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,102 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftbzip2.h |
||||
* |
||||
* Bzip2-compressed stream support. |
||||
* |
||||
* Copyright (C) 2010-2023 by |
||||
* Joel Klinghed. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTBZIP2_H_ |
||||
#define FTBZIP2_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* bzip2 |
||||
* |
||||
* @title: |
||||
* BZIP2 Streams |
||||
* |
||||
* @abstract: |
||||
* Using bzip2-compressed font files. |
||||
* |
||||
* @description: |
||||
* In certain builds of the library, bzip2 compression recognition is |
||||
* automatically handled when calling @FT_New_Face or @FT_Open_Face. |
||||
* This means that if no font driver is capable of handling the raw |
||||
* compressed file, the library will try to open a bzip2 compressed |
||||
* stream from it and re-open the face with it. |
||||
* |
||||
* The stream implementation is very basic and resets the decompression |
||||
* process each time seeking backwards is needed within the stream, |
||||
* which significantly undermines the performance. |
||||
* |
||||
* This section contains the declaration of Bzip2-specific functions. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stream_OpenBzip2 |
||||
* |
||||
* @description: |
||||
* Open a new stream to parse bzip2-compressed font files. This is |
||||
* mainly used to support the compressed `*.pcf.bz2` fonts that come with |
||||
* XFree86. |
||||
* |
||||
* @input: |
||||
* stream :: |
||||
* The target embedding stream. |
||||
* |
||||
* source :: |
||||
* The source stream. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The source stream must be opened _before_ calling this function. |
||||
* |
||||
* Calling the internal function `FT_Stream_Close` on the new stream will |
||||
* **not** call `FT_Stream_Close` on the source stream. None of the |
||||
* stream objects will be released to the heap. |
||||
* |
||||
* This function may return `FT_Err_Unimplemented_Feature` if your build |
||||
* of FreeType was not compiled with bzip2 support. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stream_OpenBzip2( FT_Stream stream, |
||||
FT_Stream source ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTBZIP2_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,168 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* This file defines the structure of the FreeType reference. |
||||
* It is used by the python script that generates the HTML files. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* general_remarks |
||||
* |
||||
* @title: |
||||
* General Remarks |
||||
* |
||||
* @sections: |
||||
* preamble |
||||
* header_inclusion |
||||
* user_allocation |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* core_api |
||||
* |
||||
* @title: |
||||
* Core API |
||||
* |
||||
* @sections: |
||||
* basic_types |
||||
* library_setup |
||||
* face_creation |
||||
* font_testing_macros |
||||
* sizing_and_scaling |
||||
* glyph_retrieval |
||||
* character_mapping |
||||
* information_retrieval |
||||
* other_api_data |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* extended_api |
||||
* |
||||
* @title: |
||||
* Extended API |
||||
* |
||||
* @sections: |
||||
* glyph_variants |
||||
* color_management |
||||
* layer_management |
||||
* glyph_management |
||||
* mac_specific |
||||
* sizes_management |
||||
* header_file_macros |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* format_specific |
||||
* |
||||
* @title: |
||||
* Format-Specific API |
||||
* |
||||
* @sections: |
||||
* multiple_masters |
||||
* truetype_tables |
||||
* type1_tables |
||||
* sfnt_names |
||||
* bdf_fonts |
||||
* cid_fonts |
||||
* pfr_fonts |
||||
* winfnt_fonts |
||||
* svg_fonts |
||||
* font_formats |
||||
* gasp_table |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* module_specific |
||||
* |
||||
* @title: |
||||
* Controlling FreeType Modules |
||||
* |
||||
* @sections: |
||||
* auto_hinter |
||||
* cff_driver |
||||
* t1_cid_driver |
||||
* tt_driver |
||||
* pcf_driver |
||||
* ot_svg_driver |
||||
* properties |
||||
* parameter_tags |
||||
* lcd_rendering |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* cache_subsystem |
||||
* |
||||
* @title: |
||||
* Cache Sub-System |
||||
* |
||||
* @sections: |
||||
* cache_subsystem |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* support_api |
||||
* |
||||
* @title: |
||||
* Support API |
||||
* |
||||
* @sections: |
||||
* computations |
||||
* list_processing |
||||
* outline_processing |
||||
* quick_advance |
||||
* bitmap_handling |
||||
* raster |
||||
* glyph_stroker |
||||
* system_interface |
||||
* module_management |
||||
* gzip |
||||
* lzw |
||||
* bzip2 |
||||
* debugging_apis |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @chapter: |
||||
* error_codes |
||||
* |
||||
* @title: |
||||
* Error Codes |
||||
* |
||||
* @sections: |
||||
* error_enumerations |
||||
* error_code_values |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,167 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftcid.h |
||||
* |
||||
* FreeType API for accessing CID font information (specification). |
||||
* |
||||
* Copyright (C) 2007-2023 by |
||||
* Dereg Clegg and Michael Toftdal. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTCID_H_ |
||||
#define FTCID_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* cid_fonts |
||||
* |
||||
* @title: |
||||
* CID Fonts |
||||
* |
||||
* @abstract: |
||||
* CID-keyed font-specific API. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of CID-keyed font-specific |
||||
* functions. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_CID_Registry_Ordering_Supplement |
||||
* |
||||
* @description: |
||||
* Retrieve the Registry/Ordering/Supplement triple (also known as the |
||||
* "R/O/S") from a CID-keyed font. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* @output: |
||||
* registry :: |
||||
* The registry, as a C~string, owned by the face. |
||||
* |
||||
* ordering :: |
||||
* The ordering, as a C~string, owned by the face. |
||||
* |
||||
* supplement :: |
||||
* The supplement. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with CID faces, returning an error |
||||
* otherwise. |
||||
* |
||||
* @since: |
||||
* 2.3.6 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_CID_Registry_Ordering_Supplement( FT_Face face, |
||||
const char* *registry, |
||||
const char* *ordering, |
||||
FT_Int *supplement ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_CID_Is_Internally_CID_Keyed |
||||
* |
||||
* @description: |
||||
* Retrieve the type of the input face, CID keyed or not. In contrast |
||||
* to the @FT_IS_CID_KEYED macro this function returns successfully also |
||||
* for CID-keyed fonts in an SFNT wrapper. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* @output: |
||||
* is_cid :: |
||||
* The type of the face as an @FT_Bool. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with CID faces and OpenType fonts, returning |
||||
* an error otherwise. |
||||
* |
||||
* @since: |
||||
* 2.3.9 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_CID_Is_Internally_CID_Keyed( FT_Face face, |
||||
FT_Bool *is_cid ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_CID_From_Glyph_Index |
||||
* |
||||
* @description: |
||||
* Retrieve the CID of the input glyph index. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* glyph_index :: |
||||
* The input glyph index. |
||||
* |
||||
* @output: |
||||
* cid :: |
||||
* The CID as an @FT_UInt. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with CID faces and OpenType fonts, returning |
||||
* an error otherwise. |
||||
* |
||||
* @since: |
||||
* 2.3.9 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_CID_From_Glyph_Index( FT_Face face, |
||||
FT_UInt glyph_index, |
||||
FT_UInt *cid ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTCID_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,283 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fterrdef.h |
||||
* |
||||
* FreeType error codes (specification). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* error_code_values |
||||
* |
||||
* @title: |
||||
* Error Code Values |
||||
* |
||||
* @abstract: |
||||
* All possible error codes returned by FreeType functions. |
||||
* |
||||
* @description: |
||||
* The list below is taken verbatim from the file `fterrdef.h` (loaded |
||||
* automatically by including `FT_FREETYPE_H`). The first argument of the |
||||
* `FT_ERROR_DEF_` macro is the error label; by default, the prefix |
||||
* `FT_Err_` gets added so that you get error names like |
||||
* `FT_Err_Cannot_Open_Resource`. The second argument is the error code, |
||||
* and the last argument an error string, which is not used by FreeType. |
||||
* |
||||
* Within your application you should **only** use error names and |
||||
* **never** its numeric values! The latter might (and actually do) |
||||
* change in forthcoming FreeType versions. |
||||
* |
||||
* Macro `FT_NOERRORDEF_` defines `FT_Err_Ok`, which is always zero. See |
||||
* the 'Error Enumerations' subsection how to automatically generate a |
||||
* list of error strings. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_Err_XXX |
||||
* |
||||
*/ |
||||
|
||||
/* generic errors */ |
||||
|
||||
FT_NOERRORDEF_( Ok, 0x00, |
||||
"no error" ) |
||||
|
||||
FT_ERRORDEF_( Cannot_Open_Resource, 0x01, |
||||
"cannot open resource" ) |
||||
FT_ERRORDEF_( Unknown_File_Format, 0x02, |
||||
"unknown file format" ) |
||||
FT_ERRORDEF_( Invalid_File_Format, 0x03, |
||||
"broken file" ) |
||||
FT_ERRORDEF_( Invalid_Version, 0x04, |
||||
"invalid FreeType version" ) |
||||
FT_ERRORDEF_( Lower_Module_Version, 0x05, |
||||
"module version is too low" ) |
||||
FT_ERRORDEF_( Invalid_Argument, 0x06, |
||||
"invalid argument" ) |
||||
FT_ERRORDEF_( Unimplemented_Feature, 0x07, |
||||
"unimplemented feature" ) |
||||
FT_ERRORDEF_( Invalid_Table, 0x08, |
||||
"broken table" ) |
||||
FT_ERRORDEF_( Invalid_Offset, 0x09, |
||||
"broken offset within table" ) |
||||
FT_ERRORDEF_( Array_Too_Large, 0x0A, |
||||
"array allocation size too large" ) |
||||
FT_ERRORDEF_( Missing_Module, 0x0B, |
||||
"missing module" ) |
||||
FT_ERRORDEF_( Missing_Property, 0x0C, |
||||
"missing property" ) |
||||
|
||||
/* glyph/character errors */ |
||||
|
||||
FT_ERRORDEF_( Invalid_Glyph_Index, 0x10, |
||||
"invalid glyph index" ) |
||||
FT_ERRORDEF_( Invalid_Character_Code, 0x11, |
||||
"invalid character code" ) |
||||
FT_ERRORDEF_( Invalid_Glyph_Format, 0x12, |
||||
"unsupported glyph image format" ) |
||||
FT_ERRORDEF_( Cannot_Render_Glyph, 0x13, |
||||
"cannot render this glyph format" ) |
||||
FT_ERRORDEF_( Invalid_Outline, 0x14, |
||||
"invalid outline" ) |
||||
FT_ERRORDEF_( Invalid_Composite, 0x15, |
||||
"invalid composite glyph" ) |
||||
FT_ERRORDEF_( Too_Many_Hints, 0x16, |
||||
"too many hints" ) |
||||
FT_ERRORDEF_( Invalid_Pixel_Size, 0x17, |
||||
"invalid pixel size" ) |
||||
FT_ERRORDEF_( Invalid_SVG_Document, 0x18, |
||||
"invalid SVG document" ) |
||||
|
||||
/* handle errors */ |
||||
|
||||
FT_ERRORDEF_( Invalid_Handle, 0x20, |
||||
"invalid object handle" ) |
||||
FT_ERRORDEF_( Invalid_Library_Handle, 0x21, |
||||
"invalid library handle" ) |
||||
FT_ERRORDEF_( Invalid_Driver_Handle, 0x22, |
||||
"invalid module handle" ) |
||||
FT_ERRORDEF_( Invalid_Face_Handle, 0x23, |
||||
"invalid face handle" ) |
||||
FT_ERRORDEF_( Invalid_Size_Handle, 0x24, |
||||
"invalid size handle" ) |
||||
FT_ERRORDEF_( Invalid_Slot_Handle, 0x25, |
||||
"invalid glyph slot handle" ) |
||||
FT_ERRORDEF_( Invalid_CharMap_Handle, 0x26, |
||||
"invalid charmap handle" ) |
||||
FT_ERRORDEF_( Invalid_Cache_Handle, 0x27, |
||||
"invalid cache manager handle" ) |
||||
FT_ERRORDEF_( Invalid_Stream_Handle, 0x28, |
||||
"invalid stream handle" ) |
||||
|
||||
/* driver errors */ |
||||
|
||||
FT_ERRORDEF_( Too_Many_Drivers, 0x30, |
||||
"too many modules" ) |
||||
FT_ERRORDEF_( Too_Many_Extensions, 0x31, |
||||
"too many extensions" ) |
||||
|
||||
/* memory errors */ |
||||
|
||||
FT_ERRORDEF_( Out_Of_Memory, 0x40, |
||||
"out of memory" ) |
||||
FT_ERRORDEF_( Unlisted_Object, 0x41, |
||||
"unlisted object" ) |
||||
|
||||
/* stream errors */ |
||||
|
||||
FT_ERRORDEF_( Cannot_Open_Stream, 0x51, |
||||
"cannot open stream" ) |
||||
FT_ERRORDEF_( Invalid_Stream_Seek, 0x52, |
||||
"invalid stream seek" ) |
||||
FT_ERRORDEF_( Invalid_Stream_Skip, 0x53, |
||||
"invalid stream skip" ) |
||||
FT_ERRORDEF_( Invalid_Stream_Read, 0x54, |
||||
"invalid stream read" ) |
||||
FT_ERRORDEF_( Invalid_Stream_Operation, 0x55, |
||||
"invalid stream operation" ) |
||||
FT_ERRORDEF_( Invalid_Frame_Operation, 0x56, |
||||
"invalid frame operation" ) |
||||
FT_ERRORDEF_( Nested_Frame_Access, 0x57, |
||||
"nested frame access" ) |
||||
FT_ERRORDEF_( Invalid_Frame_Read, 0x58, |
||||
"invalid frame read" ) |
||||
|
||||
/* raster errors */ |
||||
|
||||
FT_ERRORDEF_( Raster_Uninitialized, 0x60, |
||||
"raster uninitialized" ) |
||||
FT_ERRORDEF_( Raster_Corrupted, 0x61, |
||||
"raster corrupted" ) |
||||
FT_ERRORDEF_( Raster_Overflow, 0x62, |
||||
"raster overflow" ) |
||||
FT_ERRORDEF_( Raster_Negative_Height, 0x63, |
||||
"negative height while rastering" ) |
||||
|
||||
/* cache errors */ |
||||
|
||||
FT_ERRORDEF_( Too_Many_Caches, 0x70, |
||||
"too many registered caches" ) |
||||
|
||||
/* TrueType and SFNT errors */ |
||||
|
||||
FT_ERRORDEF_( Invalid_Opcode, 0x80, |
||||
"invalid opcode" ) |
||||
FT_ERRORDEF_( Too_Few_Arguments, 0x81, |
||||
"too few arguments" ) |
||||
FT_ERRORDEF_( Stack_Overflow, 0x82, |
||||
"stack overflow" ) |
||||
FT_ERRORDEF_( Code_Overflow, 0x83, |
||||
"code overflow" ) |
||||
FT_ERRORDEF_( Bad_Argument, 0x84, |
||||
"bad argument" ) |
||||
FT_ERRORDEF_( Divide_By_Zero, 0x85, |
||||
"division by zero" ) |
||||
FT_ERRORDEF_( Invalid_Reference, 0x86, |
||||
"invalid reference" ) |
||||
FT_ERRORDEF_( Debug_OpCode, 0x87, |
||||
"found debug opcode" ) |
||||
FT_ERRORDEF_( ENDF_In_Exec_Stream, 0x88, |
||||
"found ENDF opcode in execution stream" ) |
||||
FT_ERRORDEF_( Nested_DEFS, 0x89, |
||||
"nested DEFS" ) |
||||
FT_ERRORDEF_( Invalid_CodeRange, 0x8A, |
||||
"invalid code range" ) |
||||
FT_ERRORDEF_( Execution_Too_Long, 0x8B, |
||||
"execution context too long" ) |
||||
FT_ERRORDEF_( Too_Many_Function_Defs, 0x8C, |
||||
"too many function definitions" ) |
||||
FT_ERRORDEF_( Too_Many_Instruction_Defs, 0x8D, |
||||
"too many instruction definitions" ) |
||||
FT_ERRORDEF_( Table_Missing, 0x8E, |
||||
"SFNT font table missing" ) |
||||
FT_ERRORDEF_( Horiz_Header_Missing, 0x8F, |
||||
"horizontal header (hhea) table missing" ) |
||||
FT_ERRORDEF_( Locations_Missing, 0x90, |
||||
"locations (loca) table missing" ) |
||||
FT_ERRORDEF_( Name_Table_Missing, 0x91, |
||||
"name table missing" ) |
||||
FT_ERRORDEF_( CMap_Table_Missing, 0x92, |
||||
"character map (cmap) table missing" ) |
||||
FT_ERRORDEF_( Hmtx_Table_Missing, 0x93, |
||||
"horizontal metrics (hmtx) table missing" ) |
||||
FT_ERRORDEF_( Post_Table_Missing, 0x94, |
||||
"PostScript (post) table missing" ) |
||||
FT_ERRORDEF_( Invalid_Horiz_Metrics, 0x95, |
||||
"invalid horizontal metrics" ) |
||||
FT_ERRORDEF_( Invalid_CharMap_Format, 0x96, |
||||
"invalid character map (cmap) format" ) |
||||
FT_ERRORDEF_( Invalid_PPem, 0x97, |
||||
"invalid ppem value" ) |
||||
FT_ERRORDEF_( Invalid_Vert_Metrics, 0x98, |
||||
"invalid vertical metrics" ) |
||||
FT_ERRORDEF_( Could_Not_Find_Context, 0x99, |
||||
"could not find context" ) |
||||
FT_ERRORDEF_( Invalid_Post_Table_Format, 0x9A, |
||||
"invalid PostScript (post) table format" ) |
||||
FT_ERRORDEF_( Invalid_Post_Table, 0x9B, |
||||
"invalid PostScript (post) table" ) |
||||
FT_ERRORDEF_( DEF_In_Glyf_Bytecode, 0x9C, |
||||
"found FDEF or IDEF opcode in glyf bytecode" ) |
||||
FT_ERRORDEF_( Missing_Bitmap, 0x9D, |
||||
"missing bitmap in strike" ) |
||||
FT_ERRORDEF_( Missing_SVG_Hooks, 0x9E, |
||||
"SVG hooks have not been set" ) |
||||
|
||||
/* CFF, CID, and Type 1 errors */ |
||||
|
||||
FT_ERRORDEF_( Syntax_Error, 0xA0, |
||||
"opcode syntax error" ) |
||||
FT_ERRORDEF_( Stack_Underflow, 0xA1, |
||||
"argument stack underflow" ) |
||||
FT_ERRORDEF_( Ignore, 0xA2, |
||||
"ignore" ) |
||||
FT_ERRORDEF_( No_Unicode_Glyph_Name, 0xA3, |
||||
"no Unicode glyph name found" ) |
||||
FT_ERRORDEF_( Glyph_Too_Big, 0xA4, |
||||
"glyph too big for hinting" ) |
||||
|
||||
/* BDF errors */ |
||||
|
||||
FT_ERRORDEF_( Missing_Startfont_Field, 0xB0, |
||||
"`STARTFONT' field missing" ) |
||||
FT_ERRORDEF_( Missing_Font_Field, 0xB1, |
||||
"`FONT' field missing" ) |
||||
FT_ERRORDEF_( Missing_Size_Field, 0xB2, |
||||
"`SIZE' field missing" ) |
||||
FT_ERRORDEF_( Missing_Fontboundingbox_Field, 0xB3, |
||||
"`FONTBOUNDINGBOX' field missing" ) |
||||
FT_ERRORDEF_( Missing_Chars_Field, 0xB4, |
||||
"`CHARS' field missing" ) |
||||
FT_ERRORDEF_( Missing_Startchar_Field, 0xB5, |
||||
"`STARTCHAR' field missing" ) |
||||
FT_ERRORDEF_( Missing_Encoding_Field, 0xB6, |
||||
"`ENCODING' field missing" ) |
||||
FT_ERRORDEF_( Missing_Bbx_Field, 0xB7, |
||||
"`BBX' field missing" ) |
||||
FT_ERRORDEF_( Bbx_Too_Big, 0xB8, |
||||
"`BBX' too big" ) |
||||
FT_ERRORDEF_( Corrupted_Font_Header, 0xB9, |
||||
"Font header corrupted or missing fields" ) |
||||
FT_ERRORDEF_( Corrupted_Font_Glyphs, 0xBA, |
||||
"Font glyphs corrupted or missing fields" ) |
||||
|
||||
/* */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,296 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fterrors.h |
||||
* |
||||
* FreeType error code handling (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* error_enumerations |
||||
* |
||||
* @title: |
||||
* Error Enumerations |
||||
* |
||||
* @abstract: |
||||
* How to handle errors and error strings. |
||||
* |
||||
* @description: |
||||
* The header file `fterrors.h` (which is automatically included by |
||||
* `freetype.h`) defines the handling of FreeType's enumeration |
||||
* constants. It can also be used to generate error message strings |
||||
* with a small macro trick explained below. |
||||
* |
||||
* **Error Formats** |
||||
* |
||||
* The configuration macro `FT_CONFIG_OPTION_USE_MODULE_ERRORS` can be |
||||
* defined in `ftoption.h` in order to make the higher byte indicate the |
||||
* module where the error has happened (this is not compatible with |
||||
* standard builds of FreeType~2, however). See the file `ftmoderr.h` |
||||
* for more details. |
||||
* |
||||
* **Error Message Strings** |
||||
* |
||||
* Error definitions are set up with special macros that allow client |
||||
* applications to build a table of error message strings. The strings |
||||
* are not included in a normal build of FreeType~2 to save space (most |
||||
* client applications do not use them). |
||||
* |
||||
* To do so, you have to define the following macros before including |
||||
* this file. |
||||
* |
||||
* ``` |
||||
* FT_ERROR_START_LIST |
||||
* ``` |
||||
* |
||||
* This macro is called before anything else to define the start of the |
||||
* error list. It is followed by several `FT_ERROR_DEF` calls. |
||||
* |
||||
* ``` |
||||
* FT_ERROR_DEF( e, v, s ) |
||||
* ``` |
||||
* |
||||
* This macro is called to define one single error. 'e' is the error |
||||
* code identifier (e.g., `Invalid_Argument`), 'v' is the error's |
||||
* numerical value, and 's' is the corresponding error string. |
||||
* |
||||
* ``` |
||||
* FT_ERROR_END_LIST |
||||
* ``` |
||||
* |
||||
* This macro ends the list. |
||||
* |
||||
* Additionally, you have to undefine `FTERRORS_H_` before #including |
||||
* this file. |
||||
* |
||||
* Here is a simple example. |
||||
* |
||||
* ``` |
||||
* #undef FTERRORS_H_ |
||||
* #define FT_ERRORDEF( e, v, s ) { e, s }, |
||||
* #define FT_ERROR_START_LIST { |
||||
* #define FT_ERROR_END_LIST { 0, NULL } }; |
||||
* |
||||
* const struct |
||||
* { |
||||
* int err_code; |
||||
* const char* err_msg; |
||||
* } ft_errors[] = |
||||
* |
||||
* #include <freetype/fterrors.h> |
||||
* ``` |
||||
* |
||||
* An alternative to using an array is a switch statement. |
||||
* |
||||
* ``` |
||||
* #undef FTERRORS_H_ |
||||
* #define FT_ERROR_START_LIST switch ( error_code ) { |
||||
* #define FT_ERRORDEF( e, v, s ) case v: return s; |
||||
* #define FT_ERROR_END_LIST } |
||||
* ``` |
||||
* |
||||
* If you use `FT_CONFIG_OPTION_USE_MODULE_ERRORS`, `error_code` should |
||||
* be replaced with `FT_ERROR_BASE(error_code)` in the last example. |
||||
*/ |
||||
|
||||
/* */ |
||||
|
||||
/* In previous FreeType versions we used `__FTERRORS_H__`. However, */ |
||||
/* using two successive underscores in a non-system symbol name */ |
||||
/* violates the C (and C++) standard, so it was changed to the */ |
||||
/* current form. In spite of this, we have to make */ |
||||
/* */ |
||||
/* ``` */ |
||||
/* #undefine __FTERRORS_H__ */ |
||||
/* ``` */ |
||||
/* */ |
||||
/* work for backward compatibility. */ |
||||
/* */ |
||||
#if !( defined( FTERRORS_H_ ) && defined ( __FTERRORS_H__ ) ) |
||||
#define FTERRORS_H_ |
||||
#define __FTERRORS_H__ |
||||
|
||||
|
||||
/* include module base error codes */ |
||||
#include <freetype/ftmoderr.h> |
||||
|
||||
|
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
/***** *****/ |
||||
/***** SETUP MACROS *****/ |
||||
/***** *****/ |
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
|
||||
|
||||
#undef FT_NEED_EXTERN_C |
||||
|
||||
|
||||
/* FT_ERR_PREFIX is used as a prefix for error identifiers. */ |
||||
/* By default, we use `FT_Err_`. */ |
||||
/* */ |
||||
#ifndef FT_ERR_PREFIX |
||||
#define FT_ERR_PREFIX FT_Err_ |
||||
#endif |
||||
|
||||
|
||||
/* FT_ERR_BASE is used as the base for module-specific errors. */ |
||||
/* */ |
||||
#ifdef FT_CONFIG_OPTION_USE_MODULE_ERRORS |
||||
|
||||
#ifndef FT_ERR_BASE |
||||
#define FT_ERR_BASE FT_Mod_Err_Base |
||||
#endif |
||||
|
||||
#else |
||||
|
||||
#undef FT_ERR_BASE |
||||
#define FT_ERR_BASE 0 |
||||
|
||||
#endif /* FT_CONFIG_OPTION_USE_MODULE_ERRORS */ |
||||
|
||||
|
||||
/* If FT_ERRORDEF is not defined, we need to define a simple */ |
||||
/* enumeration type. */ |
||||
/* */ |
||||
#ifndef FT_ERRORDEF |
||||
|
||||
#define FT_INCLUDE_ERR_PROTOS |
||||
|
||||
#define FT_ERRORDEF( e, v, s ) e = v, |
||||
#define FT_ERROR_START_LIST enum { |
||||
#define FT_ERROR_END_LIST FT_ERR_CAT( FT_ERR_PREFIX, Max ) }; |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_NEED_EXTERN_C |
||||
extern "C" { |
||||
#endif |
||||
|
||||
#endif /* !FT_ERRORDEF */ |
||||
|
||||
|
||||
/* this macro is used to define an error */ |
||||
#define FT_ERRORDEF_( e, v, s ) \ |
||||
FT_ERRORDEF( FT_ERR_CAT( FT_ERR_PREFIX, e ), v + FT_ERR_BASE, s ) |
||||
|
||||
/* this is only used for <module>_Err_Ok, which must be 0! */ |
||||
#define FT_NOERRORDEF_( e, v, s ) \ |
||||
FT_ERRORDEF( FT_ERR_CAT( FT_ERR_PREFIX, e ), v, s ) |
||||
|
||||
|
||||
#ifdef FT_ERROR_START_LIST |
||||
FT_ERROR_START_LIST |
||||
#endif |
||||
|
||||
|
||||
/* now include the error codes */ |
||||
#include <freetype/fterrdef.h> |
||||
|
||||
|
||||
#ifdef FT_ERROR_END_LIST |
||||
FT_ERROR_END_LIST |
||||
#endif |
||||
|
||||
|
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
/***** *****/ |
||||
/***** SIMPLE CLEANUP *****/ |
||||
/***** *****/ |
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
|
||||
#ifdef FT_NEED_EXTERN_C |
||||
} |
||||
#endif |
||||
|
||||
#undef FT_ERROR_START_LIST |
||||
#undef FT_ERROR_END_LIST |
||||
|
||||
#undef FT_ERRORDEF |
||||
#undef FT_ERRORDEF_ |
||||
#undef FT_NOERRORDEF_ |
||||
|
||||
#undef FT_NEED_EXTERN_C |
||||
#undef FT_ERR_BASE |
||||
|
||||
/* FT_ERR_PREFIX is needed internally */ |
||||
#ifndef FT2_BUILD_LIBRARY |
||||
#undef FT_ERR_PREFIX |
||||
#endif |
||||
|
||||
/* FT_INCLUDE_ERR_PROTOS: Control whether function prototypes should be */ |
||||
/* included with */ |
||||
/* */ |
||||
/* #include <freetype/fterrors.h> */ |
||||
/* */ |
||||
/* This is only true where `FT_ERRORDEF` is */ |
||||
/* undefined. */ |
||||
/* */ |
||||
/* FT_ERR_PROTOS_DEFINED: Actual multiple-inclusion protection of */ |
||||
/* `fterrors.h`. */ |
||||
#ifdef FT_INCLUDE_ERR_PROTOS |
||||
#undef FT_INCLUDE_ERR_PROTOS |
||||
|
||||
#ifndef FT_ERR_PROTOS_DEFINED |
||||
#define FT_ERR_PROTOS_DEFINED |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Error_String |
||||
* |
||||
* @description: |
||||
* Retrieve the description of a valid FreeType error code. |
||||
* |
||||
* @input: |
||||
* error_code :: |
||||
* A valid FreeType error code. |
||||
* |
||||
* @return: |
||||
* A C~string or `NULL`, if any error occurred. |
||||
* |
||||
* @note: |
||||
* FreeType has to be compiled with `FT_CONFIG_OPTION_ERROR_STRINGS` or |
||||
* `FT_DEBUG_LEVEL_ERROR` to get meaningful descriptions. |
||||
* 'error_string' will be `NULL` otherwise. |
||||
* |
||||
* Module identification will be ignored: |
||||
* |
||||
* ```c |
||||
* strcmp( FT_Error_String( FT_Err_Unknown_File_Format ), |
||||
* FT_Error_String( BDF_Err_Unknown_File_Format ) ) == 0; |
||||
* ``` |
||||
*/ |
||||
FT_EXPORT( const char* ) |
||||
FT_Error_String( FT_Error error_code ); |
||||
|
||||
/* */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FT_ERR_PROTOS_DEFINED */ |
||||
|
||||
#endif /* FT_INCLUDE_ERR_PROTOS */ |
||||
|
||||
#endif /* !(FTERRORS_H_ && __FTERRORS_H__) */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,93 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftfntfmt.h |
||||
* |
||||
* Support functions for font formats. |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTFNTFMT_H_ |
||||
#define FTFNTFMT_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* font_formats |
||||
* |
||||
* @title: |
||||
* Font Formats |
||||
* |
||||
* @abstract: |
||||
* Getting the font format. |
||||
* |
||||
* @description: |
||||
* The single function in this section can be used to get the font format. |
||||
* Note that this information is not needed normally; however, there are |
||||
* special cases (like in PDF devices) where it is important to |
||||
* differentiate, in spite of FreeType's uniform API. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Font_Format |
||||
* |
||||
* @description: |
||||
* Return a string describing the format of a given face. Possible values |
||||
* are 'TrueType', 'Type~1', 'BDF', 'PCF', 'Type~42', 'CID~Type~1', 'CFF', |
||||
* 'PFR', and 'Windows~FNT'. |
||||
* |
||||
* The return value is suitable to be used as an X11 FONT_PROPERTY. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* Input face handle. |
||||
* |
||||
* @return: |
||||
* Font format string. `NULL` in case of error. |
||||
* |
||||
* @note: |
||||
* A deprecated name for the same function is `FT_Get_X11_Font_Format`. |
||||
*/ |
||||
FT_EXPORT( const char* ) |
||||
FT_Get_Font_Format( FT_Face face ); |
||||
|
||||
|
||||
/* deprecated */ |
||||
FT_EXPORT( const char* ) |
||||
FT_Get_X11_Font_Format( FT_Face face ); |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTFNTFMT_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,143 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftgasp.h |
||||
* |
||||
* Access of TrueType's 'gasp' table (specification). |
||||
* |
||||
* Copyright (C) 2007-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTGASP_H_ |
||||
#define FTGASP_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* gasp_table |
||||
* |
||||
* @title: |
||||
* Gasp Table |
||||
* |
||||
* @abstract: |
||||
* Retrieving TrueType 'gasp' table entries. |
||||
* |
||||
* @description: |
||||
* The function @FT_Get_Gasp can be used to query a TrueType or OpenType |
||||
* font for specific entries in its 'gasp' table, if any. This is mainly |
||||
* useful when implementing native TrueType hinting with the bytecode |
||||
* interpreter to duplicate the Windows text rendering results. |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_GASP_XXX |
||||
* |
||||
* @description: |
||||
* A list of values and/or bit-flags returned by the @FT_Get_Gasp |
||||
* function. |
||||
* |
||||
* @values: |
||||
* FT_GASP_NO_TABLE :: |
||||
* This special value means that there is no GASP table in this face. |
||||
* It is up to the client to decide what to do. |
||||
* |
||||
* FT_GASP_DO_GRIDFIT :: |
||||
* Grid-fitting and hinting should be performed at the specified ppem. |
||||
* This **really** means TrueType bytecode interpretation. If this bit |
||||
* is not set, no hinting gets applied. |
||||
* |
||||
* FT_GASP_DO_GRAY :: |
||||
* Anti-aliased rendering should be performed at the specified ppem. |
||||
* If not set, do monochrome rendering. |
||||
* |
||||
* FT_GASP_SYMMETRIC_SMOOTHING :: |
||||
* If set, smoothing along multiple axes must be used with ClearType. |
||||
* |
||||
* FT_GASP_SYMMETRIC_GRIDFIT :: |
||||
* Grid-fitting must be used with ClearType's symmetric smoothing. |
||||
* |
||||
* @note: |
||||
* The bit-flags `FT_GASP_DO_GRIDFIT` and `FT_GASP_DO_GRAY` are to be |
||||
* used for standard font rasterization only. Independently of that, |
||||
* `FT_GASP_SYMMETRIC_SMOOTHING` and `FT_GASP_SYMMETRIC_GRIDFIT` are to |
||||
* be used if ClearType is enabled (and `FT_GASP_DO_GRIDFIT` and |
||||
* `FT_GASP_DO_GRAY` are consequently ignored). |
||||
* |
||||
* 'ClearType' is Microsoft's implementation of LCD rendering, partly |
||||
* protected by patents. |
||||
* |
||||
* @since: |
||||
* 2.3.0 |
||||
*/ |
||||
#define FT_GASP_NO_TABLE -1 |
||||
#define FT_GASP_DO_GRIDFIT 0x01 |
||||
#define FT_GASP_DO_GRAY 0x02 |
||||
#define FT_GASP_SYMMETRIC_GRIDFIT 0x04 |
||||
#define FT_GASP_SYMMETRIC_SMOOTHING 0x08 |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Gasp |
||||
* |
||||
* @description: |
||||
* For a TrueType or OpenType font file, return the rasterizer behaviour |
||||
* flags from the font's 'gasp' table corresponding to a given character |
||||
* pixel size. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source face handle. |
||||
* |
||||
* ppem :: |
||||
* The vertical character pixel size. |
||||
* |
||||
* @return: |
||||
* Bit flags (see @FT_GASP_XXX), or @FT_GASP_NO_TABLE if there is no |
||||
* 'gasp' table in the face. |
||||
* |
||||
* @note: |
||||
* If you want to use the MM functionality of OpenType variation fonts |
||||
* (i.e., using @FT_Set_Var_Design_Coordinates and friends), call this |
||||
* function **after** setting an instance since the return values can |
||||
* change. |
||||
* |
||||
* @since: |
||||
* 2.3.0 |
||||
*/ |
||||
FT_EXPORT( FT_Int ) |
||||
FT_Get_Gasp( FT_Face face, |
||||
FT_UInt ppem ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTGASP_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,750 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftglyph.h |
||||
* |
||||
* FreeType convenience functions to handle glyphs (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This file contains the definition of several convenience functions that |
||||
* can be used by client applications to easily retrieve glyph bitmaps and |
||||
* outlines from a given face. |
||||
* |
||||
* These functions should be optional if you are writing a font server or |
||||
* text layout engine on top of FreeType. However, they are pretty handy |
||||
* for many other simple uses of the library. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTGLYPH_H_ |
||||
#define FTGLYPH_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* glyph_management |
||||
* |
||||
* @title: |
||||
* Glyph Management |
||||
* |
||||
* @abstract: |
||||
* Generic interface to manage individual glyph data. |
||||
* |
||||
* @description: |
||||
* This section contains definitions used to manage glyph data through |
||||
* generic @FT_Glyph objects. Each of them can contain a bitmap, |
||||
* a vector outline, or even images in other formats. These objects are |
||||
* detached from @FT_Face, contrary to @FT_GlyphSlot. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* forward declaration to a private type */ |
||||
typedef struct FT_Glyph_Class_ FT_Glyph_Class; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Glyph |
||||
* |
||||
* @description: |
||||
* Handle to an object used to model generic glyph images. It is a |
||||
* pointer to the @FT_GlyphRec structure and can contain a glyph bitmap |
||||
* or pointer. |
||||
* |
||||
* @note: |
||||
* Glyph objects are not owned by the library. You must thus release |
||||
* them manually (through @FT_Done_Glyph) _before_ calling |
||||
* @FT_Done_FreeType. |
||||
*/ |
||||
typedef struct FT_GlyphRec_* FT_Glyph; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_GlyphRec |
||||
* |
||||
* @description: |
||||
* The root glyph structure contains a given glyph image plus its advance |
||||
* width in 16.16 fixed-point format. |
||||
* |
||||
* @fields: |
||||
* library :: |
||||
* A handle to the FreeType library object. |
||||
* |
||||
* clazz :: |
||||
* A pointer to the glyph's class. Private. |
||||
* |
||||
* format :: |
||||
* The format of the glyph's image. |
||||
* |
||||
* advance :: |
||||
* A 16.16 vector that gives the glyph's advance width. |
||||
*/ |
||||
typedef struct FT_GlyphRec_ |
||||
{ |
||||
FT_Library library; |
||||
const FT_Glyph_Class* clazz; |
||||
FT_Glyph_Format format; |
||||
FT_Vector advance; |
||||
|
||||
} FT_GlyphRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_BitmapGlyph |
||||
* |
||||
* @description: |
||||
* A handle to an object used to model a bitmap glyph image. This is a |
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_BitmapGlyphRec. |
||||
*/ |
||||
typedef struct FT_BitmapGlyphRec_* FT_BitmapGlyph; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_BitmapGlyphRec |
||||
* |
||||
* @description: |
||||
* A structure used for bitmap glyph images. This really is a |
||||
* 'sub-class' of @FT_GlyphRec. |
||||
* |
||||
* @fields: |
||||
* root :: |
||||
* The root fields of @FT_Glyph. |
||||
* |
||||
* left :: |
||||
* The left-side bearing, i.e., the horizontal distance from the |
||||
* current pen position to the left border of the glyph bitmap. |
||||
* |
||||
* top :: |
||||
* The top-side bearing, i.e., the vertical distance from the current |
||||
* pen position to the top border of the glyph bitmap. This distance |
||||
* is positive for upwards~y! |
||||
* |
||||
* bitmap :: |
||||
* A descriptor for the bitmap. |
||||
* |
||||
* @note: |
||||
* You can typecast an @FT_Glyph to @FT_BitmapGlyph if you have |
||||
* `glyph->format == FT_GLYPH_FORMAT_BITMAP`. This lets you access the |
||||
* bitmap's contents easily. |
||||
* |
||||
* The corresponding pixel buffer is always owned by @FT_BitmapGlyph and |
||||
* is thus created and destroyed with it. |
||||
*/ |
||||
typedef struct FT_BitmapGlyphRec_ |
||||
{ |
||||
FT_GlyphRec root; |
||||
FT_Int left; |
||||
FT_Int top; |
||||
FT_Bitmap bitmap; |
||||
|
||||
} FT_BitmapGlyphRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_OutlineGlyph |
||||
* |
||||
* @description: |
||||
* A handle to an object used to model an outline glyph image. This is a |
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_OutlineGlyphRec. |
||||
*/ |
||||
typedef struct FT_OutlineGlyphRec_* FT_OutlineGlyph; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_OutlineGlyphRec |
||||
* |
||||
* @description: |
||||
* A structure used for outline (vectorial) glyph images. This really is |
||||
* a 'sub-class' of @FT_GlyphRec. |
||||
* |
||||
* @fields: |
||||
* root :: |
||||
* The root @FT_Glyph fields. |
||||
* |
||||
* outline :: |
||||
* A descriptor for the outline. |
||||
* |
||||
* @note: |
||||
* You can typecast an @FT_Glyph to @FT_OutlineGlyph if you have |
||||
* `glyph->format == FT_GLYPH_FORMAT_OUTLINE`. This lets you access the |
||||
* outline's content easily. |
||||
* |
||||
* As the outline is extracted from a glyph slot, its coordinates are |
||||
* expressed normally in 26.6 pixels, unless the flag @FT_LOAD_NO_SCALE |
||||
* was used in @FT_Load_Glyph or @FT_Load_Char. |
||||
* |
||||
* The outline's tables are always owned by the object and are destroyed |
||||
* with it. |
||||
*/ |
||||
typedef struct FT_OutlineGlyphRec_ |
||||
{ |
||||
FT_GlyphRec root; |
||||
FT_Outline outline; |
||||
|
||||
} FT_OutlineGlyphRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_SvgGlyph |
||||
* |
||||
* @description: |
||||
* A handle to an object used to model an SVG glyph. This is a |
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_SvgGlyphRec. |
||||
* |
||||
* @since: |
||||
* 2.12 |
||||
*/ |
||||
typedef struct FT_SvgGlyphRec_* FT_SvgGlyph; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_SvgGlyphRec |
||||
* |
||||
* @description: |
||||
* A structure used for OT-SVG glyphs. This is a 'sub-class' of |
||||
* @FT_GlyphRec. |
||||
* |
||||
* @fields: |
||||
* root :: |
||||
* The root @FT_GlyphRec fields. |
||||
* |
||||
* svg_document :: |
||||
* A pointer to the SVG document. |
||||
* |
||||
* svg_document_length :: |
||||
* The length of `svg_document`. |
||||
* |
||||
* glyph_index :: |
||||
* The index of the glyph to be rendered. |
||||
* |
||||
* metrics :: |
||||
* A metrics object storing the size information. |
||||
* |
||||
* units_per_EM :: |
||||
* The size of the EM square. |
||||
* |
||||
* start_glyph_id :: |
||||
* The first glyph ID in the glyph range covered by this document. |
||||
* |
||||
* end_glyph_id :: |
||||
* The last glyph ID in the glyph range covered by this document. |
||||
* |
||||
* transform :: |
||||
* A 2x2 transformation matrix to apply to the glyph while rendering |
||||
* it. |
||||
* |
||||
* delta :: |
||||
* Translation to apply to the glyph while rendering. |
||||
* |
||||
* @note: |
||||
* The Glyph Management API requires @FT_Glyph or its 'sub-class' to have |
||||
* all the information needed to completely define the glyph's rendering. |
||||
* Outline-based glyphs can directly apply transformations to the outline |
||||
* but this is not possible for an SVG document that hasn't been parsed. |
||||
* Therefore, the transformation is stored along with the document. In |
||||
* the absence of a 'ViewBox' or 'Width'/'Height' attribute, the size of |
||||
* the ViewPort should be assumed to be 'units_per_EM'. |
||||
*/ |
||||
typedef struct FT_SvgGlyphRec_ |
||||
{ |
||||
FT_GlyphRec root; |
||||
|
||||
FT_Byte* svg_document; |
||||
FT_ULong svg_document_length; |
||||
|
||||
FT_UInt glyph_index; |
||||
|
||||
FT_Size_Metrics metrics; |
||||
FT_UShort units_per_EM; |
||||
|
||||
FT_UShort start_glyph_id; |
||||
FT_UShort end_glyph_id; |
||||
|
||||
FT_Matrix transform; |
||||
FT_Vector delta; |
||||
|
||||
} FT_SvgGlyphRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Glyph |
||||
* |
||||
* @description: |
||||
* A function used to create a new empty glyph image. Note that the |
||||
* created @FT_Glyph object must be released with @FT_Done_Glyph. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the FreeType library object. |
||||
* |
||||
* format :: |
||||
* The format of the glyph's image. |
||||
* |
||||
* @output: |
||||
* aglyph :: |
||||
* A handle to the glyph object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @since: |
||||
* 2.10 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Glyph( FT_Library library, |
||||
FT_Glyph_Format format, |
||||
FT_Glyph *aglyph ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Glyph |
||||
* |
||||
* @description: |
||||
* A function used to extract a glyph image from a slot. Note that the |
||||
* created @FT_Glyph object must be released with @FT_Done_Glyph. |
||||
* |
||||
* @input: |
||||
* slot :: |
||||
* A handle to the source glyph slot. |
||||
* |
||||
* @output: |
||||
* aglyph :: |
||||
* A handle to the glyph object. `NULL` in case of error. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Because `*aglyph->advance.x` and `*aglyph->advance.y` are 16.16 |
||||
* fixed-point numbers, `slot->advance.x` and `slot->advance.y` (which |
||||
* are in 26.6 fixed-point format) must be in the range ]-32768;32768[. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Glyph( FT_GlyphSlot slot, |
||||
FT_Glyph *aglyph ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_Copy |
||||
* |
||||
* @description: |
||||
* A function used to copy a glyph image. Note that the created |
||||
* @FT_Glyph object must be released with @FT_Done_Glyph. |
||||
* |
||||
* @input: |
||||
* source :: |
||||
* A handle to the source glyph object. |
||||
* |
||||
* @output: |
||||
* target :: |
||||
* A handle to the target glyph object. `NULL` in case of error. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Glyph_Copy( FT_Glyph source, |
||||
FT_Glyph *target ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_Transform |
||||
* |
||||
* @description: |
||||
* Transform a glyph image if its format is scalable. |
||||
* |
||||
* @inout: |
||||
* glyph :: |
||||
* A handle to the target glyph object. |
||||
* |
||||
* @input: |
||||
* matrix :: |
||||
* A pointer to a 2x2 matrix to apply. |
||||
* |
||||
* delta :: |
||||
* A pointer to a 2d vector to apply. Coordinates are expressed in |
||||
* 1/64 of a pixel. |
||||
* |
||||
* @return: |
||||
* FreeType error code (if not 0, the glyph format is not scalable). |
||||
* |
||||
* @note: |
||||
* The 2x2 transformation matrix is also applied to the glyph's advance |
||||
* vector. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Glyph_Transform( FT_Glyph glyph, |
||||
const FT_Matrix* matrix, |
||||
const FT_Vector* delta ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_Glyph_BBox_Mode |
||||
* |
||||
* @description: |
||||
* The mode how the values of @FT_Glyph_Get_CBox are returned. |
||||
* |
||||
* @values: |
||||
* FT_GLYPH_BBOX_UNSCALED :: |
||||
* Return unscaled font units. |
||||
* |
||||
* FT_GLYPH_BBOX_SUBPIXELS :: |
||||
* Return unfitted 26.6 coordinates. |
||||
* |
||||
* FT_GLYPH_BBOX_GRIDFIT :: |
||||
* Return grid-fitted 26.6 coordinates. |
||||
* |
||||
* FT_GLYPH_BBOX_TRUNCATE :: |
||||
* Return coordinates in integer pixels. |
||||
* |
||||
* FT_GLYPH_BBOX_PIXELS :: |
||||
* Return grid-fitted pixel coordinates. |
||||
*/ |
||||
typedef enum FT_Glyph_BBox_Mode_ |
||||
{ |
||||
FT_GLYPH_BBOX_UNSCALED = 0, |
||||
FT_GLYPH_BBOX_SUBPIXELS = 0, |
||||
FT_GLYPH_BBOX_GRIDFIT = 1, |
||||
FT_GLYPH_BBOX_TRUNCATE = 2, |
||||
FT_GLYPH_BBOX_PIXELS = 3 |
||||
|
||||
} FT_Glyph_BBox_Mode; |
||||
|
||||
|
||||
/* these constants are deprecated; use the corresponding */ |
||||
/* `FT_Glyph_BBox_Mode` values instead */ |
||||
#define ft_glyph_bbox_unscaled FT_GLYPH_BBOX_UNSCALED |
||||
#define ft_glyph_bbox_subpixels FT_GLYPH_BBOX_SUBPIXELS |
||||
#define ft_glyph_bbox_gridfit FT_GLYPH_BBOX_GRIDFIT |
||||
#define ft_glyph_bbox_truncate FT_GLYPH_BBOX_TRUNCATE |
||||
#define ft_glyph_bbox_pixels FT_GLYPH_BBOX_PIXELS |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_Get_CBox |
||||
* |
||||
* @description: |
||||
* Return a glyph's 'control box'. The control box encloses all the |
||||
* outline's points, including Bezier control points. Though it |
||||
* coincides with the exact bounding box for most glyphs, it can be |
||||
* slightly larger in some situations (like when rotating an outline that |
||||
* contains Bezier outside arcs). |
||||
* |
||||
* Computing the control box is very fast, while getting the bounding box |
||||
* can take much more time as it needs to walk over all segments and arcs |
||||
* in the outline. To get the latter, you can use the 'ftbbox' |
||||
* component, which is dedicated to this single task. |
||||
* |
||||
* @input: |
||||
* glyph :: |
||||
* A handle to the source glyph object. |
||||
* |
||||
* mode :: |
||||
* The mode that indicates how to interpret the returned bounding box |
||||
* values. |
||||
* |
||||
* @output: |
||||
* acbox :: |
||||
* The glyph coordinate bounding box. Coordinates are expressed in |
||||
* 1/64 of pixels if it is grid-fitted. |
||||
* |
||||
* @note: |
||||
* Coordinates are relative to the glyph origin, using the y~upwards |
||||
* convention. |
||||
* |
||||
* If the glyph has been loaded with @FT_LOAD_NO_SCALE, `bbox_mode` must |
||||
* be set to @FT_GLYPH_BBOX_UNSCALED to get unscaled font units in 26.6 |
||||
* pixel format. The value @FT_GLYPH_BBOX_SUBPIXELS is another name for |
||||
* this constant. |
||||
* |
||||
* If the font is tricky and the glyph has been loaded with |
||||
* @FT_LOAD_NO_SCALE, the resulting CBox is meaningless. To get |
||||
* reasonable values for the CBox it is necessary to load the glyph at a |
||||
* large ppem value (so that the hinting instructions can properly shift |
||||
* and scale the subglyphs), then extracting the CBox, which can be |
||||
* eventually converted back to font units. |
||||
* |
||||
* Note that the maximum coordinates are exclusive, which means that one |
||||
* can compute the width and height of the glyph image (be it in integer |
||||
* or 26.6 pixels) as: |
||||
* |
||||
* ``` |
||||
* width = bbox.xMax - bbox.xMin; |
||||
* height = bbox.yMax - bbox.yMin; |
||||
* ``` |
||||
* |
||||
* Note also that for 26.6 coordinates, if `bbox_mode` is set to |
||||
* @FT_GLYPH_BBOX_GRIDFIT, the coordinates will also be grid-fitted, |
||||
* which corresponds to: |
||||
* |
||||
* ``` |
||||
* bbox.xMin = FLOOR(bbox.xMin); |
||||
* bbox.yMin = FLOOR(bbox.yMin); |
||||
* bbox.xMax = CEILING(bbox.xMax); |
||||
* bbox.yMax = CEILING(bbox.yMax); |
||||
* ``` |
||||
* |
||||
* To get the bbox in pixel coordinates, set `bbox_mode` to |
||||
* @FT_GLYPH_BBOX_TRUNCATE. |
||||
* |
||||
* To get the bbox in grid-fitted pixel coordinates, set `bbox_mode` to |
||||
* @FT_GLYPH_BBOX_PIXELS. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Glyph_Get_CBox( FT_Glyph glyph, |
||||
FT_UInt bbox_mode, |
||||
FT_BBox *acbox ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_To_Bitmap |
||||
* |
||||
* @description: |
||||
* Convert a given glyph object to a bitmap glyph object. |
||||
* |
||||
* @inout: |
||||
* the_glyph :: |
||||
* A pointer to a handle to the target glyph. |
||||
* |
||||
* @input: |
||||
* render_mode :: |
||||
* An enumeration that describes how the data is rendered. |
||||
* |
||||
* origin :: |
||||
* A pointer to a vector used to translate the glyph image before |
||||
* rendering. Can be~0 (if no translation). The origin is expressed |
||||
* in 26.6 pixels. |
||||
* |
||||
* destroy :: |
||||
* A boolean that indicates that the original glyph image should be |
||||
* destroyed by this function. It is never destroyed in case of error. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function does nothing if the glyph format isn't scalable. |
||||
* |
||||
* The glyph image is translated with the `origin` vector before |
||||
* rendering. |
||||
* |
||||
* The first parameter is a pointer to an @FT_Glyph handle that will be |
||||
* _replaced_ by this function (with newly allocated data). Typically, |
||||
* you would do something like the following (omitting error handling). |
||||
* |
||||
* ``` |
||||
* FT_Glyph glyph; |
||||
* FT_BitmapGlyph glyph_bitmap; |
||||
* |
||||
* |
||||
* // load glyph
|
||||
* error = FT_Load_Char( face, glyph_index, FT_LOAD_DEFAULT ); |
||||
* |
||||
* // extract glyph image
|
||||
* error = FT_Get_Glyph( face->glyph, &glyph ); |
||||
* |
||||
* // convert to a bitmap (default render mode + destroying old)
|
||||
* if ( glyph->format != FT_GLYPH_FORMAT_BITMAP ) |
||||
* { |
||||
* error = FT_Glyph_To_Bitmap( &glyph, FT_RENDER_MODE_NORMAL, |
||||
* 0, 1 ); |
||||
* if ( error ) // `glyph' unchanged
|
||||
* ... |
||||
* } |
||||
* |
||||
* // access bitmap content by typecasting
|
||||
* glyph_bitmap = (FT_BitmapGlyph)glyph; |
||||
* |
||||
* // do funny stuff with it, like blitting/drawing
|
||||
* ... |
||||
* |
||||
* // discard glyph image (bitmap or not)
|
||||
* FT_Done_Glyph( glyph ); |
||||
* ``` |
||||
* |
||||
* Here is another example, again without error handling. |
||||
* |
||||
* ``` |
||||
* FT_Glyph glyphs[MAX_GLYPHS] |
||||
* |
||||
* |
||||
* ... |
||||
* |
||||
* for ( idx = 0; i < MAX_GLYPHS; i++ ) |
||||
* error = FT_Load_Glyph( face, idx, FT_LOAD_DEFAULT ) || |
||||
* FT_Get_Glyph ( face->glyph, &glyphs[idx] ); |
||||
* |
||||
* ... |
||||
* |
||||
* for ( idx = 0; i < MAX_GLYPHS; i++ ) |
||||
* { |
||||
* FT_Glyph bitmap = glyphs[idx]; |
||||
* |
||||
* |
||||
* ... |
||||
* |
||||
* // after this call, `bitmap' no longer points into
|
||||
* // the `glyphs' array (and the old value isn't destroyed)
|
||||
* FT_Glyph_To_Bitmap( &bitmap, FT_RENDER_MODE_MONO, 0, 0 ); |
||||
* |
||||
* ... |
||||
* |
||||
* FT_Done_Glyph( bitmap ); |
||||
* } |
||||
* |
||||
* ... |
||||
* |
||||
* for ( idx = 0; i < MAX_GLYPHS; i++ ) |
||||
* FT_Done_Glyph( glyphs[idx] ); |
||||
* ``` |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Glyph_To_Bitmap( FT_Glyph* the_glyph, |
||||
FT_Render_Mode render_mode, |
||||
const FT_Vector* origin, |
||||
FT_Bool destroy ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Done_Glyph |
||||
* |
||||
* @description: |
||||
* Destroy a given glyph. |
||||
* |
||||
* @input: |
||||
* glyph :: |
||||
* A handle to the target glyph object. Can be `NULL`. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Done_Glyph( FT_Glyph glyph ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
/* other helpful functions */ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* computations |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Matrix_Multiply |
||||
* |
||||
* @description: |
||||
* Perform the matrix operation `b = a*b`. |
||||
* |
||||
* @input: |
||||
* a :: |
||||
* A pointer to matrix `a`. |
||||
* |
||||
* @inout: |
||||
* b :: |
||||
* A pointer to matrix `b`. |
||||
* |
||||
* @note: |
||||
* The result is undefined if either `a` or `b` is zero. |
||||
* |
||||
* Since the function uses wrap-around arithmetic, results become |
||||
* meaningless if the arguments are very large. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Matrix_Multiply( const FT_Matrix* a, |
||||
FT_Matrix* b ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Matrix_Invert |
||||
* |
||||
* @description: |
||||
* Invert a 2x2 matrix. Return an error if it can't be inverted. |
||||
* |
||||
* @inout: |
||||
* matrix :: |
||||
* A pointer to the target matrix. Remains untouched in case of error. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Matrix_Invert( FT_Matrix* matrix ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTGLYPH_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
|
||||
|
||||
/* Local Variables: */ |
||||
/* coding: utf-8 */ |
||||
/* End: */ |
||||
@ -0,0 +1,354 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftgxval.h |
||||
* |
||||
* FreeType API for validating TrueTypeGX/AAT tables (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 by |
||||
* Masatake YAMATO, Redhat K.K, |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
/****************************************************************************
|
||||
* |
||||
* gxvalid is derived from both gxlayout module and otvalid module. |
||||
* Development of gxlayout is supported by the Information-technology |
||||
* Promotion Agency(IPA), Japan. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTGXVAL_H_ |
||||
#define FTGXVAL_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* gx_validation |
||||
* |
||||
* @title: |
||||
* TrueTypeGX/AAT Validation |
||||
* |
||||
* @abstract: |
||||
* An API to validate TrueTypeGX/AAT tables. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of functions to validate some |
||||
* TrueTypeGX tables (feat, mort, morx, bsln, just, kern, opbd, trak, |
||||
* prop, lcar). |
||||
* |
||||
* @order: |
||||
* FT_TrueTypeGX_Validate |
||||
* FT_TrueTypeGX_Free |
||||
* |
||||
* FT_ClassicKern_Validate |
||||
* FT_ClassicKern_Free |
||||
* |
||||
* FT_VALIDATE_GX_LENGTH |
||||
* FT_VALIDATE_GXXXX |
||||
* FT_VALIDATE_CKERNXXX |
||||
* |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* |
||||
* Warning: Use `FT_VALIDATE_XXX` to validate a table. |
||||
* Following definitions are for gxvalid developers. |
||||
* |
||||
* |
||||
*/ |
||||
|
||||
#define FT_VALIDATE_feat_INDEX 0 |
||||
#define FT_VALIDATE_mort_INDEX 1 |
||||
#define FT_VALIDATE_morx_INDEX 2 |
||||
#define FT_VALIDATE_bsln_INDEX 3 |
||||
#define FT_VALIDATE_just_INDEX 4 |
||||
#define FT_VALIDATE_kern_INDEX 5 |
||||
#define FT_VALIDATE_opbd_INDEX 6 |
||||
#define FT_VALIDATE_trak_INDEX 7 |
||||
#define FT_VALIDATE_prop_INDEX 8 |
||||
#define FT_VALIDATE_lcar_INDEX 9 |
||||
#define FT_VALIDATE_GX_LAST_INDEX FT_VALIDATE_lcar_INDEX |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_VALIDATE_GX_LENGTH |
||||
* |
||||
* @description: |
||||
* The number of tables checked in this module. Use it as a parameter |
||||
* for the `table-length` argument of function @FT_TrueTypeGX_Validate. |
||||
*/ |
||||
#define FT_VALIDATE_GX_LENGTH ( FT_VALIDATE_GX_LAST_INDEX + 1 ) |
||||
|
||||
/* */ |
||||
|
||||
/* Up to 0x1000 is used by otvalid.
|
||||
Ox2xxx is reserved for feature OT extension. */ |
||||
#define FT_VALIDATE_GX_START 0x4000 |
||||
#define FT_VALIDATE_GX_BITFIELD( tag ) \ |
||||
( FT_VALIDATE_GX_START << FT_VALIDATE_##tag##_INDEX ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_VALIDATE_GXXXX |
||||
* |
||||
* @description: |
||||
* A list of bit-field constants used with @FT_TrueTypeGX_Validate to |
||||
* indicate which TrueTypeGX/AAT Type tables should be validated. |
||||
* |
||||
* @values: |
||||
* FT_VALIDATE_feat :: |
||||
* Validate 'feat' table. |
||||
* |
||||
* FT_VALIDATE_mort :: |
||||
* Validate 'mort' table. |
||||
* |
||||
* FT_VALIDATE_morx :: |
||||
* Validate 'morx' table. |
||||
* |
||||
* FT_VALIDATE_bsln :: |
||||
* Validate 'bsln' table. |
||||
* |
||||
* FT_VALIDATE_just :: |
||||
* Validate 'just' table. |
||||
* |
||||
* FT_VALIDATE_kern :: |
||||
* Validate 'kern' table. |
||||
* |
||||
* FT_VALIDATE_opbd :: |
||||
* Validate 'opbd' table. |
||||
* |
||||
* FT_VALIDATE_trak :: |
||||
* Validate 'trak' table. |
||||
* |
||||
* FT_VALIDATE_prop :: |
||||
* Validate 'prop' table. |
||||
* |
||||
* FT_VALIDATE_lcar :: |
||||
* Validate 'lcar' table. |
||||
* |
||||
* FT_VALIDATE_GX :: |
||||
* Validate all TrueTypeGX tables (feat, mort, morx, bsln, just, kern, |
||||
* opbd, trak, prop and lcar). |
||||
* |
||||
*/ |
||||
|
||||
#define FT_VALIDATE_feat FT_VALIDATE_GX_BITFIELD( feat ) |
||||
#define FT_VALIDATE_mort FT_VALIDATE_GX_BITFIELD( mort ) |
||||
#define FT_VALIDATE_morx FT_VALIDATE_GX_BITFIELD( morx ) |
||||
#define FT_VALIDATE_bsln FT_VALIDATE_GX_BITFIELD( bsln ) |
||||
#define FT_VALIDATE_just FT_VALIDATE_GX_BITFIELD( just ) |
||||
#define FT_VALIDATE_kern FT_VALIDATE_GX_BITFIELD( kern ) |
||||
#define FT_VALIDATE_opbd FT_VALIDATE_GX_BITFIELD( opbd ) |
||||
#define FT_VALIDATE_trak FT_VALIDATE_GX_BITFIELD( trak ) |
||||
#define FT_VALIDATE_prop FT_VALIDATE_GX_BITFIELD( prop ) |
||||
#define FT_VALIDATE_lcar FT_VALIDATE_GX_BITFIELD( lcar ) |
||||
|
||||
#define FT_VALIDATE_GX ( FT_VALIDATE_feat | \ |
||||
FT_VALIDATE_mort | \
|
||||
FT_VALIDATE_morx | \
|
||||
FT_VALIDATE_bsln | \
|
||||
FT_VALIDATE_just | \
|
||||
FT_VALIDATE_kern | \
|
||||
FT_VALIDATE_opbd | \
|
||||
FT_VALIDATE_trak | \
|
||||
FT_VALIDATE_prop | \
|
||||
FT_VALIDATE_lcar ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_TrueTypeGX_Validate |
||||
* |
||||
* @description: |
||||
* Validate various TrueTypeGX tables to assure that all offsets and |
||||
* indices are valid. The idea is that a higher-level library that |
||||
* actually does the text layout can access those tables without error |
||||
* checking (which can be quite time consuming). |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* validation_flags :: |
||||
* A bit field that specifies the tables to be validated. See |
||||
* @FT_VALIDATE_GXXXX for possible values. |
||||
* |
||||
* table_length :: |
||||
* The size of the `tables` array. Normally, @FT_VALIDATE_GX_LENGTH |
||||
* should be passed. |
||||
* |
||||
* @output: |
||||
* tables :: |
||||
* The array where all validated sfnt tables are stored. The array |
||||
* itself must be allocated by a client. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with TrueTypeGX fonts, returning an error |
||||
* otherwise. |
||||
* |
||||
* After use, the application should deallocate the buffers pointed to by |
||||
* each `tables` element, by calling @FT_TrueTypeGX_Free. A `NULL` value |
||||
* indicates that the table either doesn't exist in the font, the |
||||
* application hasn't asked for validation, or the validator doesn't have |
||||
* the ability to validate the sfnt table. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_TrueTypeGX_Validate( FT_Face face, |
||||
FT_UInt validation_flags, |
||||
FT_Bytes tables[FT_VALIDATE_GX_LENGTH], |
||||
FT_UInt table_length ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_TrueTypeGX_Free |
||||
* |
||||
* @description: |
||||
* Free the buffer allocated by TrueTypeGX validator. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* table :: |
||||
* The pointer to the buffer allocated by @FT_TrueTypeGX_Validate. |
||||
* |
||||
* @note: |
||||
* This function must be used to free the buffer allocated by |
||||
* @FT_TrueTypeGX_Validate only. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_TrueTypeGX_Free( FT_Face face, |
||||
FT_Bytes table ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_VALIDATE_CKERNXXX |
||||
* |
||||
* @description: |
||||
* A list of bit-field constants used with @FT_ClassicKern_Validate to |
||||
* indicate the classic kern dialect or dialects. If the selected type |
||||
* doesn't fit, @FT_ClassicKern_Validate regards the table as invalid. |
||||
* |
||||
* @values: |
||||
* FT_VALIDATE_MS :: |
||||
* Handle the 'kern' table as a classic Microsoft kern table. |
||||
* |
||||
* FT_VALIDATE_APPLE :: |
||||
* Handle the 'kern' table as a classic Apple kern table. |
||||
* |
||||
* FT_VALIDATE_CKERN :: |
||||
* Handle the 'kern' as either classic Apple or Microsoft kern table. |
||||
*/ |
||||
#define FT_VALIDATE_MS ( FT_VALIDATE_GX_START << 0 ) |
||||
#define FT_VALIDATE_APPLE ( FT_VALIDATE_GX_START << 1 ) |
||||
|
||||
#define FT_VALIDATE_CKERN ( FT_VALIDATE_MS | FT_VALIDATE_APPLE ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_ClassicKern_Validate |
||||
* |
||||
* @description: |
||||
* Validate classic (16-bit format) kern table to assure that the |
||||
* offsets and indices are valid. The idea is that a higher-level |
||||
* library that actually does the text layout can access those tables |
||||
* without error checking (which can be quite time consuming). |
||||
* |
||||
* The 'kern' table validator in @FT_TrueTypeGX_Validate deals with both |
||||
* the new 32-bit format and the classic 16-bit format, while |
||||
* FT_ClassicKern_Validate only supports the classic 16-bit format. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* validation_flags :: |
||||
* A bit field that specifies the dialect to be validated. See |
||||
* @FT_VALIDATE_CKERNXXX for possible values. |
||||
* |
||||
* @output: |
||||
* ckern_table :: |
||||
* A pointer to the kern table. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* After use, the application should deallocate the buffers pointed to by |
||||
* `ckern_table`, by calling @FT_ClassicKern_Free. A `NULL` value |
||||
* indicates that the table doesn't exist in the font. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_ClassicKern_Validate( FT_Face face, |
||||
FT_UInt validation_flags, |
||||
FT_Bytes *ckern_table ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_ClassicKern_Free |
||||
* |
||||
* @description: |
||||
* Free the buffer allocated by classic Kern validator. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* table :: |
||||
* The pointer to the buffer that is allocated by |
||||
* @FT_ClassicKern_Validate. |
||||
* |
||||
* @note: |
||||
* This function must be used to free the buffer allocated by |
||||
* @FT_ClassicKern_Validate only. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_ClassicKern_Free( FT_Face face, |
||||
FT_Bytes table ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTGXVAL_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,151 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftgzip.h |
||||
* |
||||
* Gzip-compressed stream support. |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTGZIP_H_ |
||||
#define FTGZIP_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* gzip |
||||
* |
||||
* @title: |
||||
* GZIP Streams |
||||
* |
||||
* @abstract: |
||||
* Using gzip-compressed font files. |
||||
* |
||||
* @description: |
||||
* In certain builds of the library, gzip compression recognition is |
||||
* automatically handled when calling @FT_New_Face or @FT_Open_Face. |
||||
* This means that if no font driver is capable of handling the raw |
||||
* compressed file, the library will try to open a gzipped stream from it |
||||
* and re-open the face with it. |
||||
* |
||||
* The stream implementation is very basic and resets the decompression |
||||
* process each time seeking backwards is needed within the stream, |
||||
* which significantly undermines the performance. |
||||
* |
||||
* This section contains the declaration of Gzip-specific functions. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stream_OpenGzip |
||||
* |
||||
* @description: |
||||
* Open a new stream to parse gzip-compressed font files. This is mainly |
||||
* used to support the compressed `*.pcf.gz` fonts that come with |
||||
* XFree86. |
||||
* |
||||
* @input: |
||||
* stream :: |
||||
* The target embedding stream. |
||||
* |
||||
* source :: |
||||
* The source stream. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The source stream must be opened _before_ calling this function. |
||||
* |
||||
* Calling the internal function `FT_Stream_Close` on the new stream will |
||||
* **not** call `FT_Stream_Close` on the source stream. None of the |
||||
* stream objects will be released to the heap. |
||||
* |
||||
* This function may return `FT_Err_Unimplemented_Feature` if your build |
||||
* of FreeType was not compiled with zlib support. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stream_OpenGzip( FT_Stream stream, |
||||
FT_Stream source ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Gzip_Uncompress |
||||
* |
||||
* @description: |
||||
* Decompress a zipped input buffer into an output buffer. This function |
||||
* is modeled after zlib's `uncompress` function. |
||||
* |
||||
* @input: |
||||
* memory :: |
||||
* A FreeType memory handle. |
||||
* |
||||
* input :: |
||||
* The input buffer. |
||||
* |
||||
* input_len :: |
||||
* The length of the input buffer. |
||||
* |
||||
* @output: |
||||
* output :: |
||||
* The output buffer. |
||||
* |
||||
* @inout: |
||||
* output_len :: |
||||
* Before calling the function, this is the total size of the output |
||||
* buffer, which must be large enough to hold the entire uncompressed |
||||
* data (so the size of the uncompressed data must be known in |
||||
* advance). After calling the function, `output_len` is the size of |
||||
* the used data in `output`. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function may return `FT_Err_Unimplemented_Feature` if your build |
||||
* of FreeType was not compiled with zlib support. |
||||
* |
||||
* @since: |
||||
* 2.5.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Gzip_Uncompress( FT_Memory memory, |
||||
FT_Byte* output, |
||||
FT_ULong* output_len, |
||||
const FT_Byte* input, |
||||
FT_ULong input_len ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTGZIP_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,348 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftincrem.h |
||||
* |
||||
* FreeType incremental loading (specification). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTINCREM_H_ |
||||
#define FTINCREM_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/ftparams.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* incremental |
||||
* |
||||
* @title: |
||||
* Incremental Loading |
||||
* |
||||
* @abstract: |
||||
* Custom Glyph Loading. |
||||
* |
||||
* @description: |
||||
* This section contains various functions used to perform so-called |
||||
* 'incremental' glyph loading. This is a mode where all glyphs loaded |
||||
* from a given @FT_Face are provided by the client application. |
||||
* |
||||
* Apart from that, all other tables are loaded normally from the font |
||||
* file. This mode is useful when FreeType is used within another |
||||
* engine, e.g., a PostScript Imaging Processor. |
||||
* |
||||
* To enable this mode, you must use @FT_Open_Face, passing an |
||||
* @FT_Parameter with the @FT_PARAM_TAG_INCREMENTAL tag and an |
||||
* @FT_Incremental_Interface value. See the comments for |
||||
* @FT_Incremental_InterfaceRec for an example. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Incremental |
||||
* |
||||
* @description: |
||||
* An opaque type describing a user-provided object used to implement |
||||
* 'incremental' glyph loading within FreeType. This is used to support |
||||
* embedded fonts in certain environments (e.g., PostScript |
||||
* interpreters), where the glyph data isn't in the font file, or must be |
||||
* overridden by different values. |
||||
* |
||||
* @note: |
||||
* It is up to client applications to create and implement |
||||
* @FT_Incremental objects, as long as they provide implementations for |
||||
* the methods @FT_Incremental_GetGlyphDataFunc, |
||||
* @FT_Incremental_FreeGlyphDataFunc and |
||||
* @FT_Incremental_GetGlyphMetricsFunc. |
||||
* |
||||
* See the description of @FT_Incremental_InterfaceRec to understand how |
||||
* to use incremental objects with FreeType. |
||||
* |
||||
*/ |
||||
typedef struct FT_IncrementalRec_* FT_Incremental; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Incremental_MetricsRec |
||||
* |
||||
* @description: |
||||
* A small structure used to contain the basic glyph metrics returned by |
||||
* the @FT_Incremental_GetGlyphMetricsFunc method. |
||||
* |
||||
* @fields: |
||||
* bearing_x :: |
||||
* Left bearing, in font units. |
||||
* |
||||
* bearing_y :: |
||||
* Top bearing, in font units. |
||||
* |
||||
* advance :: |
||||
* Horizontal component of glyph advance, in font units. |
||||
* |
||||
* advance_v :: |
||||
* Vertical component of glyph advance, in font units. |
||||
* |
||||
* @note: |
||||
* These correspond to horizontal or vertical metrics depending on the |
||||
* value of the `vertical` argument to the function |
||||
* @FT_Incremental_GetGlyphMetricsFunc. |
||||
* |
||||
*/ |
||||
typedef struct FT_Incremental_MetricsRec_ |
||||
{ |
||||
FT_Long bearing_x; |
||||
FT_Long bearing_y; |
||||
FT_Long advance; |
||||
FT_Long advance_v; /* since 2.3.12 */ |
||||
|
||||
} FT_Incremental_MetricsRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Incremental_Metrics |
||||
* |
||||
* @description: |
||||
* A handle to an @FT_Incremental_MetricsRec structure. |
||||
* |
||||
*/ |
||||
typedef struct FT_Incremental_MetricsRec_* FT_Incremental_Metrics; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Incremental_GetGlyphDataFunc |
||||
* |
||||
* @description: |
||||
* A function called by FreeType to access a given glyph's data bytes |
||||
* during @FT_Load_Glyph or @FT_Load_Char if incremental loading is |
||||
* enabled. |
||||
* |
||||
* Note that the format of the glyph's data bytes depends on the font |
||||
* file format. For TrueType, it must correspond to the raw bytes within |
||||
* the 'glyf' table. For PostScript formats, it must correspond to the |
||||
* **unencrypted** charstring bytes, without any `lenIV` header. It is |
||||
* undefined for any other format. |
||||
* |
||||
* @input: |
||||
* incremental :: |
||||
* Handle to an opaque @FT_Incremental handle provided by the client |
||||
* application. |
||||
* |
||||
* glyph_index :: |
||||
* Index of relevant glyph. |
||||
* |
||||
* @output: |
||||
* adata :: |
||||
* A structure describing the returned glyph data bytes (which will be |
||||
* accessed as a read-only byte block). |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If this function returns successfully the method |
||||
* @FT_Incremental_FreeGlyphDataFunc will be called later to release the |
||||
* data bytes. |
||||
* |
||||
* Nested calls to @FT_Incremental_GetGlyphDataFunc can happen for |
||||
* compound glyphs. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_Incremental_GetGlyphDataFunc)( FT_Incremental incremental, |
||||
FT_UInt glyph_index, |
||||
FT_Data* adata ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Incremental_FreeGlyphDataFunc |
||||
* |
||||
* @description: |
||||
* A function used to release the glyph data bytes returned by a |
||||
* successful call to @FT_Incremental_GetGlyphDataFunc. |
||||
* |
||||
* @input: |
||||
* incremental :: |
||||
* A handle to an opaque @FT_Incremental handle provided by the client |
||||
* application. |
||||
* |
||||
* data :: |
||||
* A structure describing the glyph data bytes (which will be accessed |
||||
* as a read-only byte block). |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*FT_Incremental_FreeGlyphDataFunc)( FT_Incremental incremental, |
||||
FT_Data* data ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Incremental_GetGlyphMetricsFunc |
||||
* |
||||
* @description: |
||||
* A function used to retrieve the basic metrics of a given glyph index |
||||
* before accessing its data. This allows for handling font types such |
||||
* as PCL~XL Format~1, Class~2 downloaded TrueType fonts, where the glyph |
||||
* metrics (`hmtx` and `vmtx` tables) are permitted to be omitted from |
||||
* the font, and the relevant metrics included in the header of the glyph |
||||
* outline data. Importantly, this is not intended to allow custom glyph |
||||
* metrics (for example, Postscript Metrics dictionaries), because that |
||||
* conflicts with the requirements of outline hinting. Such custom |
||||
* metrics must be handled separately, by the calling application. |
||||
* |
||||
* @input: |
||||
* incremental :: |
||||
* A handle to an opaque @FT_Incremental handle provided by the client |
||||
* application. |
||||
* |
||||
* glyph_index :: |
||||
* Index of relevant glyph. |
||||
* |
||||
* vertical :: |
||||
* If true, return vertical metrics. |
||||
* |
||||
* ametrics :: |
||||
* This parameter is used for both input and output. The original |
||||
* glyph metrics, if any, in font units. If metrics are not available |
||||
* all the values must be set to zero. |
||||
* |
||||
* @output: |
||||
* ametrics :: |
||||
* The glyph metrics in font units. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_Incremental_GetGlyphMetricsFunc) |
||||
( FT_Incremental incremental, |
||||
FT_UInt glyph_index, |
||||
FT_Bool vertical, |
||||
FT_Incremental_MetricsRec *ametrics ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Incremental_FuncsRec |
||||
* |
||||
* @description: |
||||
* A table of functions for accessing fonts that load data incrementally. |
||||
* Used in @FT_Incremental_InterfaceRec. |
||||
* |
||||
* @fields: |
||||
* get_glyph_data :: |
||||
* The function to get glyph data. Must not be null. |
||||
* |
||||
* free_glyph_data :: |
||||
* The function to release glyph data. Must not be null. |
||||
* |
||||
* get_glyph_metrics :: |
||||
* The function to get glyph metrics. May be null if the font does not |
||||
* require it. |
||||
* |
||||
*/ |
||||
typedef struct FT_Incremental_FuncsRec_ |
||||
{ |
||||
FT_Incremental_GetGlyphDataFunc get_glyph_data; |
||||
FT_Incremental_FreeGlyphDataFunc free_glyph_data; |
||||
FT_Incremental_GetGlyphMetricsFunc get_glyph_metrics; |
||||
|
||||
} FT_Incremental_FuncsRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Incremental_InterfaceRec |
||||
* |
||||
* @description: |
||||
* A structure to be used with @FT_Open_Face to indicate that the user |
||||
* wants to support incremental glyph loading. You should use it with |
||||
* @FT_PARAM_TAG_INCREMENTAL as in the following example: |
||||
* |
||||
* ``` |
||||
* FT_Incremental_InterfaceRec inc_int; |
||||
* FT_Parameter parameter; |
||||
* FT_Open_Args open_args; |
||||
* |
||||
* |
||||
* // set up incremental descriptor
|
||||
* inc_int.funcs = my_funcs; |
||||
* inc_int.object = my_object; |
||||
* |
||||
* // set up optional parameter
|
||||
* parameter.tag = FT_PARAM_TAG_INCREMENTAL; |
||||
* parameter.data = &inc_int; |
||||
* |
||||
* // set up FT_Open_Args structure
|
||||
* open_args.flags = FT_OPEN_PATHNAME | FT_OPEN_PARAMS; |
||||
* open_args.pathname = my_font_pathname; |
||||
* open_args.num_params = 1; |
||||
* open_args.params = ¶meter; // we use one optional argument
|
||||
* |
||||
* // open the font
|
||||
* error = FT_Open_Face( library, &open_args, index, &face ); |
||||
* ... |
||||
* ``` |
||||
* |
||||
*/ |
||||
typedef struct FT_Incremental_InterfaceRec_ |
||||
{ |
||||
const FT_Incremental_FuncsRec* funcs; |
||||
FT_Incremental object; |
||||
|
||||
} FT_Incremental_InterfaceRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Incremental_Interface |
||||
* |
||||
* @description: |
||||
* A pointer to an @FT_Incremental_InterfaceRec structure. |
||||
* |
||||
*/ |
||||
typedef FT_Incremental_InterfaceRec* FT_Incremental_Interface; |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTINCREM_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,323 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftlcdfil.h |
||||
* |
||||
* FreeType API for color filtering of subpixel bitmap glyphs |
||||
* (specification). |
||||
* |
||||
* Copyright (C) 2006-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTLCDFIL_H_ |
||||
#define FTLCDFIL_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/ftparams.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* lcd_rendering |
||||
* |
||||
* @title: |
||||
* Subpixel Rendering |
||||
* |
||||
* @abstract: |
||||
* API to control subpixel rendering. |
||||
* |
||||
* @description: |
||||
* FreeType provides two alternative subpixel rendering technologies. |
||||
* Should you define `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` in your |
||||
* `ftoption.h` file, this enables ClearType-style rendering. |
||||
* Otherwise, Harmony LCD rendering is enabled. These technologies are |
||||
* controlled differently and API described below, although always |
||||
* available, performs its function when appropriate method is enabled |
||||
* and does nothing otherwise. |
||||
* |
||||
* ClearType-style LCD rendering exploits the color-striped structure of |
||||
* LCD pixels, increasing the available resolution in the direction of |
||||
* the stripe (usually horizontal RGB) by a factor of~3. Using the |
||||
* subpixel coverages unfiltered can create severe color fringes |
||||
* especially when rendering thin features. Indeed, to produce |
||||
* black-on-white text, the nearby color subpixels must be dimmed |
||||
* evenly. Therefore, an equalizing 5-tap FIR filter should be applied |
||||
* to subpixel coverages regardless of pixel boundaries and should have |
||||
* these properties: |
||||
* |
||||
* 1. It should be symmetrical, like {~a, b, c, b, a~}, to avoid |
||||
* any shifts in appearance. |
||||
* |
||||
* 2. It should be color-balanced, meaning a~+ b~=~c, to reduce color |
||||
* fringes by distributing the computed coverage for one subpixel to |
||||
* all subpixels equally. |
||||
* |
||||
* 3. It should be normalized, meaning 2a~+ 2b~+ c~=~1.0 to maintain |
||||
* overall brightness. |
||||
* |
||||
* Boxy 3-tap filter {0, 1/3, 1/3, 1/3, 0} is sharper but is less |
||||
* forgiving of non-ideal gamma curves of a screen (and viewing angles), |
||||
* beveled filters are fuzzier but more tolerant. |
||||
* |
||||
* Use the @FT_Library_SetLcdFilter or @FT_Library_SetLcdFilterWeights |
||||
* API to specify a low-pass filter, which is then applied to |
||||
* subpixel-rendered bitmaps generated through @FT_Render_Glyph. |
||||
* |
||||
* Harmony LCD rendering is suitable to panels with any regular subpixel |
||||
* structure, not just monitors with 3 color striped subpixels, as long |
||||
* as the color subpixels have fixed positions relative to the pixel |
||||
* center. In this case, each color channel can be rendered separately |
||||
* after shifting the outline opposite to the subpixel shift so that the |
||||
* coverage maps are aligned. This method is immune to color fringes |
||||
* because the shifts do not change integral coverage. |
||||
* |
||||
* The subpixel geometry must be specified by xy-coordinates for each |
||||
* subpixel. By convention they may come in the RGB order: {{-1/3, 0}, |
||||
* {0, 0}, {1/3, 0}} for standard RGB striped panel or {{-1/6, 1/4}, |
||||
* {-1/6, -1/4}, {1/3, 0}} for a certain PenTile panel. |
||||
* |
||||
* Use the @FT_Library_SetLcdGeometry API to specify subpixel positions. |
||||
* If one follows the RGB order convention, the same order applies to the |
||||
* resulting @FT_PIXEL_MODE_LCD and @FT_PIXEL_MODE_LCD_V bitmaps. Note, |
||||
* however, that the coordinate frame for the latter must be rotated |
||||
* clockwise. Harmony with default LCD geometry is equivalent to |
||||
* ClearType with light filter. |
||||
* |
||||
* As a result of ClearType filtering or Harmony shifts, the resulting |
||||
* dimensions of LCD bitmaps can be slightly wider or taller than the |
||||
* dimensions the original outline with regard to the pixel grid. |
||||
* For example, for @FT_RENDER_MODE_LCD, the filter adds 2~subpixels to |
||||
* the left, and 2~subpixels to the right. The bitmap offset values are |
||||
* adjusted accordingly, so clients shouldn't need to modify their layout |
||||
* and glyph positioning code when enabling the filter. |
||||
* |
||||
* The ClearType and Harmony rendering is applicable to glyph bitmaps |
||||
* rendered through @FT_Render_Glyph, @FT_Load_Glyph, @FT_Load_Char, and |
||||
* @FT_Glyph_To_Bitmap, when @FT_RENDER_MODE_LCD or @FT_RENDER_MODE_LCD_V |
||||
* is specified. This API does not control @FT_Outline_Render and |
||||
* @FT_Outline_Get_Bitmap. |
||||
* |
||||
* The described algorithms can completely remove color artefacts when |
||||
* combined with gamma-corrected alpha blending in linear space. Each of |
||||
* the 3~alpha values (subpixels) must by independently used to blend one |
||||
* color channel. That is, red alpha blends the red channel of the text |
||||
* color with the red channel of the background pixel. |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_LcdFilter |
||||
* |
||||
* @description: |
||||
* A list of values to identify various types of LCD filters. |
||||
* |
||||
* @values: |
||||
* FT_LCD_FILTER_NONE :: |
||||
* Do not perform filtering. When used with subpixel rendering, this |
||||
* results in sometimes severe color fringes. |
||||
* |
||||
* FT_LCD_FILTER_DEFAULT :: |
||||
* This is a beveled, normalized, and color-balanced five-tap filter |
||||
* with weights of [0x08 0x4D 0x56 0x4D 0x08] in 1/256 units. |
||||
* |
||||
* FT_LCD_FILTER_LIGHT :: |
||||
* this is a boxy, normalized, and color-balanced three-tap filter with |
||||
* weights of [0x00 0x55 0x56 0x55 0x00] in 1/256 units. |
||||
* |
||||
* FT_LCD_FILTER_LEGACY :: |
||||
* FT_LCD_FILTER_LEGACY1 :: |
||||
* This filter corresponds to the original libXft color filter. It |
||||
* provides high contrast output but can exhibit really bad color |
||||
* fringes if glyphs are not extremely well hinted to the pixel grid. |
||||
* This filter is only provided for comparison purposes, and might be |
||||
* disabled or stay unsupported in the future. The second value is |
||||
* provided for compatibility with FontConfig, which historically used |
||||
* different enumeration, sometimes incorrectly forwarded to FreeType. |
||||
* |
||||
* @since: |
||||
* 2.3.0 (`FT_LCD_FILTER_LEGACY1` since 2.6.2) |
||||
*/ |
||||
typedef enum FT_LcdFilter_ |
||||
{ |
||||
FT_LCD_FILTER_NONE = 0, |
||||
FT_LCD_FILTER_DEFAULT = 1, |
||||
FT_LCD_FILTER_LIGHT = 2, |
||||
FT_LCD_FILTER_LEGACY1 = 3, |
||||
FT_LCD_FILTER_LEGACY = 16, |
||||
|
||||
FT_LCD_FILTER_MAX /* do not remove */ |
||||
|
||||
} FT_LcdFilter; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Library_SetLcdFilter |
||||
* |
||||
* @description: |
||||
* This function is used to change filter applied to LCD decimated |
||||
* bitmaps, like the ones used when calling @FT_Render_Glyph with |
||||
* @FT_RENDER_MODE_LCD or @FT_RENDER_MODE_LCD_V. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the target library instance. |
||||
* |
||||
* filter :: |
||||
* The filter type. |
||||
* |
||||
* You can use @FT_LCD_FILTER_NONE here to disable this feature, or |
||||
* @FT_LCD_FILTER_DEFAULT to use a default filter that should work well |
||||
* on most LCD screens. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Since 2.10.3 the LCD filtering is enabled with @FT_LCD_FILTER_DEFAULT. |
||||
* It is no longer necessary to call this function explicitly except |
||||
* to choose a different filter or disable filtering altogether with |
||||
* @FT_LCD_FILTER_NONE. |
||||
* |
||||
* This function does nothing but returns `FT_Err_Unimplemented_Feature` |
||||
* if the configuration macro `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is |
||||
* not defined in your build of the library. |
||||
* |
||||
* @since: |
||||
* 2.3.0 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Library_SetLcdFilter( FT_Library library, |
||||
FT_LcdFilter filter ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Library_SetLcdFilterWeights |
||||
* |
||||
* @description: |
||||
* This function can be used to enable LCD filter with custom weights, |
||||
* instead of using presets in @FT_Library_SetLcdFilter. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the target library instance. |
||||
* |
||||
* weights :: |
||||
* A pointer to an array; the function copies the first five bytes and |
||||
* uses them to specify the filter weights in 1/256 units. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function does nothing but returns `FT_Err_Unimplemented_Feature` |
||||
* if the configuration macro `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is |
||||
* not defined in your build of the library. |
||||
* |
||||
* LCD filter weights can also be set per face using @FT_Face_Properties |
||||
* with @FT_PARAM_TAG_LCD_FILTER_WEIGHTS. |
||||
* |
||||
* @since: |
||||
* 2.4.0 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Library_SetLcdFilterWeights( FT_Library library, |
||||
unsigned char *weights ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_LcdFiveTapFilter |
||||
* |
||||
* @description: |
||||
* A typedef for passing the five LCD filter weights to |
||||
* @FT_Face_Properties within an @FT_Parameter structure. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_LCD_FILTER_FIVE_TAPS 5 |
||||
|
||||
typedef FT_Byte FT_LcdFiveTapFilter[FT_LCD_FILTER_FIVE_TAPS]; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Library_SetLcdGeometry |
||||
* |
||||
* @description: |
||||
* This function can be used to modify default positions of color |
||||
* subpixels, which controls Harmony LCD rendering. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the target library instance. |
||||
* |
||||
* sub :: |
||||
* A pointer to an array of 3 vectors in 26.6 fractional pixel format; |
||||
* the function modifies the default values, see the note below. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Subpixel geometry examples: |
||||
* |
||||
* - {{-21, 0}, {0, 0}, {21, 0}} is the default, corresponding to 3 color |
||||
* stripes shifted by a third of a pixel. This could be an RGB panel. |
||||
* |
||||
* - {{21, 0}, {0, 0}, {-21, 0}} looks the same as the default but can |
||||
* specify a BGR panel instead, while keeping the bitmap in the same |
||||
* RGB888 format. |
||||
* |
||||
* - {{0, 21}, {0, 0}, {0, -21}} is the vertical RGB, but the bitmap |
||||
* stays RGB888 as a result. |
||||
* |
||||
* - {{-11, 16}, {-11, -16}, {22, 0}} is a certain PenTile arrangement. |
||||
* |
||||
* This function does nothing and returns `FT_Err_Unimplemented_Feature` |
||||
* in the context of ClearType-style subpixel rendering when |
||||
* `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is defined in your build of the |
||||
* library. |
||||
* |
||||
* @since: |
||||
* 2.10.0 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Library_SetLcdGeometry( FT_Library library, |
||||
FT_Vector sub[3] ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTLCDFIL_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,296 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftlist.h |
||||
* |
||||
* Generic list support for FreeType (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This file implements functions relative to list processing. Its data |
||||
* structures are defined in `freetype.h`. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTLIST_H_ |
||||
#define FTLIST_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* list_processing |
||||
* |
||||
* @title: |
||||
* List Processing |
||||
* |
||||
* @abstract: |
||||
* Simple management of lists. |
||||
* |
||||
* @description: |
||||
* This section contains various definitions related to list processing |
||||
* using doubly-linked nodes. |
||||
* |
||||
* @order: |
||||
* FT_List |
||||
* FT_ListNode |
||||
* FT_ListRec |
||||
* FT_ListNodeRec |
||||
* |
||||
* FT_List_Add |
||||
* FT_List_Insert |
||||
* FT_List_Find |
||||
* FT_List_Remove |
||||
* FT_List_Up |
||||
* FT_List_Iterate |
||||
* FT_List_Iterator |
||||
* FT_List_Finalize |
||||
* FT_List_Destructor |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Find |
||||
* |
||||
* @description: |
||||
* Find the list node for a given listed object. |
||||
* |
||||
* @input: |
||||
* list :: |
||||
* A pointer to the parent list. |
||||
* data :: |
||||
* The address of the listed object. |
||||
* |
||||
* @return: |
||||
* List node. `NULL` if it wasn't found. |
||||
*/ |
||||
FT_EXPORT( FT_ListNode ) |
||||
FT_List_Find( FT_List list, |
||||
void* data ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Add |
||||
* |
||||
* @description: |
||||
* Append an element to the end of a list. |
||||
* |
||||
* @inout: |
||||
* list :: |
||||
* A pointer to the parent list. |
||||
* node :: |
||||
* The node to append. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_List_Add( FT_List list, |
||||
FT_ListNode node ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Insert |
||||
* |
||||
* @description: |
||||
* Insert an element at the head of a list. |
||||
* |
||||
* @inout: |
||||
* list :: |
||||
* A pointer to parent list. |
||||
* node :: |
||||
* The node to insert. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_List_Insert( FT_List list, |
||||
FT_ListNode node ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Remove |
||||
* |
||||
* @description: |
||||
* Remove a node from a list. This function doesn't check whether the |
||||
* node is in the list! |
||||
* |
||||
* @input: |
||||
* node :: |
||||
* The node to remove. |
||||
* |
||||
* @inout: |
||||
* list :: |
||||
* A pointer to the parent list. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_List_Remove( FT_List list, |
||||
FT_ListNode node ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Up |
||||
* |
||||
* @description: |
||||
* Move a node to the head/top of a list. Used to maintain LRU lists. |
||||
* |
||||
* @inout: |
||||
* list :: |
||||
* A pointer to the parent list. |
||||
* node :: |
||||
* The node to move. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_List_Up( FT_List list, |
||||
FT_ListNode node ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_List_Iterator |
||||
* |
||||
* @description: |
||||
* An FT_List iterator function that is called during a list parse by |
||||
* @FT_List_Iterate. |
||||
* |
||||
* @input: |
||||
* node :: |
||||
* The current iteration list node. |
||||
* |
||||
* user :: |
||||
* A typeless pointer passed to @FT_List_Iterate. Can be used to point |
||||
* to the iteration's state. |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_List_Iterator)( FT_ListNode node, |
||||
void* user ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Iterate |
||||
* |
||||
* @description: |
||||
* Parse a list and calls a given iterator function on each element. |
||||
* Note that parsing is stopped as soon as one of the iterator calls |
||||
* returns a non-zero value. |
||||
* |
||||
* @input: |
||||
* list :: |
||||
* A handle to the list. |
||||
* iterator :: |
||||
* An iterator function, called on each node of the list. |
||||
* user :: |
||||
* A user-supplied field that is passed as the second argument to the |
||||
* iterator. |
||||
* |
||||
* @return: |
||||
* The result (a FreeType error code) of the last iterator call. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_List_Iterate( FT_List list, |
||||
FT_List_Iterator iterator, |
||||
void* user ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_List_Destructor |
||||
* |
||||
* @description: |
||||
* An @FT_List iterator function that is called during a list |
||||
* finalization by @FT_List_Finalize to destroy all elements in a given |
||||
* list. |
||||
* |
||||
* @input: |
||||
* system :: |
||||
* The current system object. |
||||
* |
||||
* data :: |
||||
* The current object to destroy. |
||||
* |
||||
* user :: |
||||
* A typeless pointer passed to @FT_List_Iterate. It can be used to |
||||
* point to the iteration's state. |
||||
*/ |
||||
typedef void |
||||
(*FT_List_Destructor)( FT_Memory memory, |
||||
void* data, |
||||
void* user ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_List_Finalize |
||||
* |
||||
* @description: |
||||
* Destroy all elements in the list as well as the list itself. |
||||
* |
||||
* @input: |
||||
* list :: |
||||
* A handle to the list. |
||||
* |
||||
* destroy :: |
||||
* A list destructor that will be applied to each element of the list. |
||||
* Set this to `NULL` if not needed. |
||||
* |
||||
* memory :: |
||||
* The current memory object that handles deallocation. |
||||
* |
||||
* user :: |
||||
* A user-supplied field that is passed as the last argument to the |
||||
* destructor. |
||||
* |
||||
* @note: |
||||
* This function expects that all nodes added by @FT_List_Add or |
||||
* @FT_List_Insert have been dynamically allocated. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_List_Finalize( FT_List list, |
||||
FT_List_Destructor destroy, |
||||
FT_Memory memory, |
||||
void* user ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTLIST_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,184 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftlogging.h |
||||
* |
||||
* Additional debugging APIs. |
||||
* |
||||
* Copyright (C) 2020-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTLOGGING_H_ |
||||
#define FTLOGGING_H_ |
||||
|
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_CONFIG_H |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* debugging_apis |
||||
* |
||||
* @title: |
||||
* External Debugging APIs |
||||
* |
||||
* @abstract: |
||||
* Public APIs to control the `FT_DEBUG_LOGGING` macro. |
||||
* |
||||
* @description: |
||||
* This section contains the declarations of public functions that |
||||
* enables fine control of what the `FT_DEBUG_LOGGING` macro outputs. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Set_Level |
||||
* |
||||
* @description: |
||||
* Change the levels of tracing components of FreeType at run time. |
||||
* |
||||
* @input: |
||||
* tracing_level :: |
||||
* New tracing value. |
||||
* |
||||
* @example: |
||||
* The following call makes FreeType trace everything but the 'memory' |
||||
* component. |
||||
* |
||||
* ``` |
||||
* FT_Trace_Set_Level( "any:7 memory:0" ); |
||||
* ``` |
||||
* |
||||
* @note: |
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING` |
||||
* isn't set. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Trace_Set_Level( const char* tracing_level ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Set_Default_Level |
||||
* |
||||
* @description: |
||||
* Reset tracing value of FreeType's components to the default value |
||||
* (i.e., to the value of the `FT2_DEBUG` environment value or to NULL |
||||
* if `FT2_DEBUG` is not set). |
||||
* |
||||
* @note: |
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING` |
||||
* isn't set. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Trace_Set_Default_Level( void ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Custom_Log_Handler |
||||
* |
||||
* @description: |
||||
* A function typedef that is used to handle the logging of tracing and |
||||
* debug messages on a file system. |
||||
* |
||||
* @input: |
||||
* ft_component :: |
||||
* The name of `FT_COMPONENT` from which the current debug or error |
||||
* message is produced. |
||||
* |
||||
* fmt :: |
||||
* Actual debug or tracing message. |
||||
* |
||||
* args:: |
||||
* Arguments of debug or tracing messages. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*FT_Custom_Log_Handler)( const char* ft_component, |
||||
const char* fmt, |
||||
va_list args ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Log_Handler |
||||
* |
||||
* @description: |
||||
* A function to set a custom log handler. |
||||
* |
||||
* @input: |
||||
* handler :: |
||||
* New logging function. |
||||
* |
||||
* @note: |
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING` |
||||
* isn't set. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Set_Log_Handler( FT_Custom_Log_Handler handler ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Default_Log_Handler |
||||
* |
||||
* @description: |
||||
* A function to undo the effect of @FT_Set_Log_Handler, resetting the |
||||
* log handler to FreeType's built-in version. |
||||
* |
||||
* @note: |
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING` |
||||
* isn't set. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Set_Default_Log_Handler( void ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTLOGGING_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,100 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftlzw.h |
||||
* |
||||
* LZW-compressed stream support. |
||||
* |
||||
* Copyright (C) 2004-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTLZW_H_ |
||||
#define FTLZW_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* lzw |
||||
* |
||||
* @title: |
||||
* LZW Streams |
||||
* |
||||
* @abstract: |
||||
* Using LZW-compressed font files. |
||||
* |
||||
* @description: |
||||
* In certain builds of the library, LZW compression recognition is |
||||
* automatically handled when calling @FT_New_Face or @FT_Open_Face. |
||||
* This means that if no font driver is capable of handling the raw |
||||
* compressed file, the library will try to open a LZW stream from it and |
||||
* re-open the face with it. |
||||
* |
||||
* The stream implementation is very basic and resets the decompression |
||||
* process each time seeking backwards is needed within the stream, |
||||
* which significantly undermines the performance. |
||||
* |
||||
* This section contains the declaration of LZW-specific functions. |
||||
* |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stream_OpenLZW |
||||
* |
||||
* @description: |
||||
* Open a new stream to parse LZW-compressed font files. This is mainly |
||||
* used to support the compressed `*.pcf.Z` fonts that come with XFree86. |
||||
* |
||||
* @input: |
||||
* stream :: |
||||
* The target embedding stream. |
||||
* |
||||
* source :: |
||||
* The source stream. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The source stream must be opened _before_ calling this function. |
||||
* |
||||
* Calling the internal function `FT_Stream_Close` on the new stream will |
||||
* **not** call `FT_Stream_Close` on the source stream. None of the |
||||
* stream objects will be released to the heap. |
||||
* |
||||
* This function may return `FT_Err_Unimplemented_Feature` if your build |
||||
* of FreeType was not compiled with LZW support. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stream_OpenLZW( FT_Stream stream, |
||||
FT_Stream source ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTLZW_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,289 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmac.h |
||||
* |
||||
* Additional Mac-specific API. |
||||
* |
||||
* Copyright (C) 1996-2023 by |
||||
* Just van Rossum, 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/****************************************************************************
|
||||
* |
||||
* NOTE: Include this file after `FT_FREETYPE_H` and after any |
||||
* Mac-specific headers (because this header uses Mac types such as |
||||
* 'Handle', 'FSSpec', 'FSRef', etc.) |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMAC_H_ |
||||
#define FTMAC_H_ |
||||
|
||||
|
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/* gcc-3.1 and later can warn about functions tagged as deprecated */ |
||||
#ifndef FT_DEPRECATED_ATTRIBUTE |
||||
#if defined( __GNUC__ ) && \ |
||||
( ( __GNUC__ >= 4 ) || \
|
||||
( ( __GNUC__ == 3 ) && ( __GNUC_MINOR__ >= 1 ) ) ) |
||||
#define FT_DEPRECATED_ATTRIBUTE __attribute__(( deprecated )) |
||||
#else |
||||
#define FT_DEPRECATED_ATTRIBUTE |
||||
#endif |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* mac_specific |
||||
* |
||||
* @title: |
||||
* Mac Specific Interface |
||||
* |
||||
* @abstract: |
||||
* Only available on the Macintosh. |
||||
* |
||||
* @description: |
||||
* The following definitions are only available if FreeType is compiled |
||||
* on a Macintosh. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Face_From_FOND |
||||
* |
||||
* @description: |
||||
* Create a new face object from a FOND resource. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library resource. |
||||
* |
||||
* @input: |
||||
* fond :: |
||||
* A FOND resource. |
||||
* |
||||
* face_index :: |
||||
* Only supported for the -1 'sanity check' special case. |
||||
* |
||||
* @output: |
||||
* aface :: |
||||
* A handle to a new face object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @example: |
||||
* This function can be used to create @FT_Face objects from fonts that |
||||
* are installed in the system as follows. |
||||
* |
||||
* ``` |
||||
* fond = GetResource( 'FOND', fontName ); |
||||
* error = FT_New_Face_From_FOND( library, fond, 0, &face ); |
||||
* ``` |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Face_From_FOND( FT_Library library, |
||||
Handle fond, |
||||
FT_Long face_index, |
||||
FT_Face *aface ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_GetFile_From_Mac_Name |
||||
* |
||||
* @description: |
||||
* Return an FSSpec for the disk file containing the named font. |
||||
* |
||||
* @input: |
||||
* fontName :: |
||||
* Mac OS name of the font (e.g., Times New Roman Bold). |
||||
* |
||||
* @output: |
||||
* pathSpec :: |
||||
* FSSpec to the file. For passing to @FT_New_Face_From_FSSpec. |
||||
* |
||||
* face_index :: |
||||
* Index of the face. For passing to @FT_New_Face_From_FSSpec. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_GetFile_From_Mac_Name( const char* fontName, |
||||
FSSpec* pathSpec, |
||||
FT_Long* face_index ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_GetFile_From_Mac_ATS_Name |
||||
* |
||||
* @description: |
||||
* Return an FSSpec for the disk file containing the named font. |
||||
* |
||||
* @input: |
||||
* fontName :: |
||||
* Mac OS name of the font in ATS framework. |
||||
* |
||||
* @output: |
||||
* pathSpec :: |
||||
* FSSpec to the file. For passing to @FT_New_Face_From_FSSpec. |
||||
* |
||||
* face_index :: |
||||
* Index of the face. For passing to @FT_New_Face_From_FSSpec. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_GetFile_From_Mac_ATS_Name( const char* fontName, |
||||
FSSpec* pathSpec, |
||||
FT_Long* face_index ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_GetFilePath_From_Mac_ATS_Name |
||||
* |
||||
* @description: |
||||
* Return a pathname of the disk file and face index for given font name |
||||
* that is handled by ATS framework. |
||||
* |
||||
* @input: |
||||
* fontName :: |
||||
* Mac OS name of the font in ATS framework. |
||||
* |
||||
* @output: |
||||
* path :: |
||||
* Buffer to store pathname of the file. For passing to @FT_New_Face. |
||||
* The client must allocate this buffer before calling this function. |
||||
* |
||||
* maxPathSize :: |
||||
* Lengths of the buffer `path` that client allocated. |
||||
* |
||||
* face_index :: |
||||
* Index of the face. For passing to @FT_New_Face. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_GetFilePath_From_Mac_ATS_Name( const char* fontName, |
||||
UInt8* path, |
||||
UInt32 maxPathSize, |
||||
FT_Long* face_index ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Face_From_FSSpec |
||||
* |
||||
* @description: |
||||
* Create a new face object from a given resource and typeface index |
||||
* using an FSSpec to the font file. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library resource. |
||||
* |
||||
* @input: |
||||
* spec :: |
||||
* FSSpec to the font file. |
||||
* |
||||
* face_index :: |
||||
* The index of the face within the resource. The first face has |
||||
* index~0. |
||||
* @output: |
||||
* aface :: |
||||
* A handle to a new face object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* @FT_New_Face_From_FSSpec is identical to @FT_New_Face except it |
||||
* accepts an FSSpec instead of a path. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Face_From_FSSpec( FT_Library library, |
||||
const FSSpec *spec, |
||||
FT_Long face_index, |
||||
FT_Face *aface ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Face_From_FSRef |
||||
* |
||||
* @description: |
||||
* Create a new face object from a given resource and typeface index |
||||
* using an FSRef to the font file. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library resource. |
||||
* |
||||
* @input: |
||||
* spec :: |
||||
* FSRef to the font file. |
||||
* |
||||
* face_index :: |
||||
* The index of the face within the resource. The first face has |
||||
* index~0. |
||||
* @output: |
||||
* aface :: |
||||
* A handle to a new face object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* @FT_New_Face_From_FSRef is identical to @FT_New_Face except it accepts |
||||
* an FSRef instead of a path. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Face_From_FSRef( FT_Library library, |
||||
const FSRef *ref, |
||||
FT_Long face_index, |
||||
FT_Face *aface ) |
||||
FT_DEPRECATED_ATTRIBUTE; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FTMAC_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,805 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmm.h |
||||
* |
||||
* FreeType Multiple Master font interface (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMM_H_ |
||||
#define FTMM_H_ |
||||
|
||||
|
||||
#include <freetype/t1tables.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* multiple_masters |
||||
* |
||||
* @title: |
||||
* Multiple Masters |
||||
* |
||||
* @abstract: |
||||
* How to manage Multiple Masters fonts. |
||||
* |
||||
* @description: |
||||
* The following types and functions are used to manage Multiple Master |
||||
* fonts, i.e., the selection of specific design instances by setting |
||||
* design axis coordinates. |
||||
* |
||||
* Besides Adobe MM fonts, the interface supports Apple's TrueType GX and |
||||
* OpenType variation fonts. Some of the routines only work with Adobe |
||||
* MM fonts, others will work with all three types. They are similar |
||||
* enough that a consistent interface makes sense. |
||||
* |
||||
* For Adobe MM fonts, macro @FT_IS_SFNT returns false. For GX and |
||||
* OpenType variation fonts, it returns true. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_MM_Axis |
||||
* |
||||
* @description: |
||||
* A structure to model a given axis in design space for Multiple Masters |
||||
* fonts. |
||||
* |
||||
* This structure can't be used for TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @fields: |
||||
* name :: |
||||
* The axis's name. |
||||
* |
||||
* minimum :: |
||||
* The axis's minimum design coordinate. |
||||
* |
||||
* maximum :: |
||||
* The axis's maximum design coordinate. |
||||
*/ |
||||
typedef struct FT_MM_Axis_ |
||||
{ |
||||
FT_String* name; |
||||
FT_Long minimum; |
||||
FT_Long maximum; |
||||
|
||||
} FT_MM_Axis; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Multi_Master |
||||
* |
||||
* @description: |
||||
* A structure to model the axes and space of a Multiple Masters font. |
||||
* |
||||
* This structure can't be used for TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @fields: |
||||
* num_axis :: |
||||
* Number of axes. Cannot exceed~4. |
||||
* |
||||
* num_designs :: |
||||
* Number of designs; should be normally 2^num_axis even though the |
||||
* Type~1 specification strangely allows for intermediate designs to be |
||||
* present. This number cannot exceed~16. |
||||
* |
||||
* axis :: |
||||
* A table of axis descriptors. |
||||
*/ |
||||
typedef struct FT_Multi_Master_ |
||||
{ |
||||
FT_UInt num_axis; |
||||
FT_UInt num_designs; |
||||
FT_MM_Axis axis[T1_MAX_MM_AXIS]; |
||||
|
||||
} FT_Multi_Master; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Var_Axis |
||||
* |
||||
* @description: |
||||
* A structure to model a given axis in design space for Multiple |
||||
* Masters, TrueType GX, and OpenType variation fonts. |
||||
* |
||||
* @fields: |
||||
* name :: |
||||
* The axis's name. Not always meaningful for TrueType GX or OpenType |
||||
* variation fonts. |
||||
* |
||||
* minimum :: |
||||
* The axis's minimum design coordinate. |
||||
* |
||||
* def :: |
||||
* The axis's default design coordinate. FreeType computes meaningful |
||||
* default values for Adobe MM fonts. |
||||
* |
||||
* maximum :: |
||||
* The axis's maximum design coordinate. |
||||
* |
||||
* tag :: |
||||
* The axis's tag (the equivalent to 'name' for TrueType GX and |
||||
* OpenType variation fonts). FreeType provides default values for |
||||
* Adobe MM fonts if possible. |
||||
* |
||||
* strid :: |
||||
* The axis name entry in the font's 'name' table. This is another |
||||
* (and often better) version of the 'name' field for TrueType GX or |
||||
* OpenType variation fonts. Not meaningful for Adobe MM fonts. |
||||
* |
||||
* @note: |
||||
* The fields `minimum`, `def`, and `maximum` are 16.16 fractional values |
||||
* for TrueType GX and OpenType variation fonts. For Adobe MM fonts, the |
||||
* values are whole numbers (i.e., the fractional part is zero). |
||||
*/ |
||||
typedef struct FT_Var_Axis_ |
||||
{ |
||||
FT_String* name; |
||||
|
||||
FT_Fixed minimum; |
||||
FT_Fixed def; |
||||
FT_Fixed maximum; |
||||
|
||||
FT_ULong tag; |
||||
FT_UInt strid; |
||||
|
||||
} FT_Var_Axis; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Var_Named_Style |
||||
* |
||||
* @description: |
||||
* A structure to model a named instance in a TrueType GX or OpenType |
||||
* variation font. |
||||
* |
||||
* This structure can't be used for Adobe MM fonts. |
||||
* |
||||
* @fields: |
||||
* coords :: |
||||
* The design coordinates for this instance. This is an array with one |
||||
* entry for each axis. |
||||
* |
||||
* strid :: |
||||
* The entry in 'name' table identifying this instance. |
||||
* |
||||
* psid :: |
||||
* The entry in 'name' table identifying a PostScript name for this |
||||
* instance. Value 0xFFFF indicates a missing entry. |
||||
*/ |
||||
typedef struct FT_Var_Named_Style_ |
||||
{ |
||||
FT_Fixed* coords; |
||||
FT_UInt strid; |
||||
FT_UInt psid; /* since 2.7.1 */ |
||||
|
||||
} FT_Var_Named_Style; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_MM_Var |
||||
* |
||||
* @description: |
||||
* A structure to model the axes and space of an Adobe MM, TrueType GX, |
||||
* or OpenType variation font. |
||||
* |
||||
* Some fields are specific to one format and not to the others. |
||||
* |
||||
* @fields: |
||||
* num_axis :: |
||||
* The number of axes. The maximum value is~4 for Adobe MM fonts; no |
||||
* limit in TrueType GX or OpenType variation fonts. |
||||
* |
||||
* num_designs :: |
||||
* The number of designs; should be normally 2^num_axis for Adobe MM |
||||
* fonts. Not meaningful for TrueType GX or OpenType variation fonts |
||||
* (where every glyph could have a different number of designs). |
||||
* |
||||
* num_namedstyles :: |
||||
* The number of named styles; a 'named style' is a tuple of design |
||||
* coordinates that has a string ID (in the 'name' table) associated |
||||
* with it. The font can tell the user that, for example, |
||||
* [Weight=1.5,Width=1.1] is 'Bold'. Another name for 'named style' is |
||||
* 'named instance'. |
||||
* |
||||
* For Adobe Multiple Masters fonts, this value is always zero because |
||||
* the format does not support named styles. |
||||
* |
||||
* axis :: |
||||
* An axis descriptor table. TrueType GX and OpenType variation fonts |
||||
* contain slightly more data than Adobe MM fonts. Memory management |
||||
* of this pointer is done internally by FreeType. |
||||
* |
||||
* namedstyle :: |
||||
* A named style (instance) table. Only meaningful for TrueType GX and |
||||
* OpenType variation fonts. Memory management of this pointer is done |
||||
* internally by FreeType. |
||||
*/ |
||||
typedef struct FT_MM_Var_ |
||||
{ |
||||
FT_UInt num_axis; |
||||
FT_UInt num_designs; |
||||
FT_UInt num_namedstyles; |
||||
FT_Var_Axis* axis; |
||||
FT_Var_Named_Style* namedstyle; |
||||
|
||||
} FT_MM_Var; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Multi_Master |
||||
* |
||||
* @description: |
||||
* Retrieve a variation descriptor of a given Adobe MM font. |
||||
* |
||||
* This function can't be used with TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @output: |
||||
* amaster :: |
||||
* The Multiple Masters descriptor. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Multi_Master( FT_Face face, |
||||
FT_Multi_Master *amaster ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_MM_Var |
||||
* |
||||
* @description: |
||||
* Retrieve a variation descriptor for a given font. |
||||
* |
||||
* This function works with all supported variation formats. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @output: |
||||
* amaster :: |
||||
* The variation descriptor. Allocates a data structure, which the |
||||
* user must deallocate with a call to @FT_Done_MM_Var after use. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_MM_Var( FT_Face face, |
||||
FT_MM_Var* *amaster ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Done_MM_Var |
||||
* |
||||
* @description: |
||||
* Free the memory allocated by @FT_Get_MM_Var. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle of the face's parent library object that was used in the |
||||
* call to @FT_Get_MM_Var to create `amaster`. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Done_MM_Var( FT_Library library, |
||||
FT_MM_Var *amaster ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_MM_Design_Coordinates |
||||
* |
||||
* @description: |
||||
* For Adobe MM fonts, choose an interpolated font design through design |
||||
* coordinates. |
||||
* |
||||
* This function can't be used with TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @inout: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @input: |
||||
* num_coords :: |
||||
* The number of available design coordinates. If it is larger than |
||||
* the number of axes, ignore the excess values. If it is smaller than |
||||
* the number of axes, use default values for the remaining axes. |
||||
* |
||||
* coords :: |
||||
* An array of design coordinates. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* [Since 2.8.1] To reset all axes to the default values, call the |
||||
* function with `num_coords` set to zero and `coords` set to `NULL`. |
||||
* |
||||
* [Since 2.9] If `num_coords` is larger than zero, this function sets |
||||
* the @FT_FACE_FLAG_VARIATION bit in @FT_Face's `face_flags` field |
||||
* (i.e., @FT_IS_VARIATION will return true). If `num_coords` is zero, |
||||
* this bit flag gets unset. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_MM_Design_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Long* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Var_Design_Coordinates |
||||
* |
||||
* @description: |
||||
* Choose an interpolated font design through design coordinates. |
||||
* |
||||
* This function works with all supported variation formats. |
||||
* |
||||
* @inout: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @input: |
||||
* num_coords :: |
||||
* The number of available design coordinates. If it is larger than |
||||
* the number of axes, ignore the excess values. If it is smaller than |
||||
* the number of axes, use default values for the remaining axes. |
||||
* |
||||
* coords :: |
||||
* An array of design coordinates. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The design coordinates are 16.16 fractional values for TrueType GX and |
||||
* OpenType variation fonts. For Adobe MM fonts, the values are supposed |
||||
* to be whole numbers (i.e., the fractional part is zero). |
||||
* |
||||
* [Since 2.8.1] To reset all axes to the default values, call the |
||||
* function with `num_coords` set to zero and `coords` set to `NULL`. |
||||
* [Since 2.9] 'Default values' means the currently selected named |
||||
* instance (or the base font if no named instance is selected). |
||||
* |
||||
* [Since 2.9] If `num_coords` is larger than zero, this function sets |
||||
* the @FT_FACE_FLAG_VARIATION bit in @FT_Face's `face_flags` field |
||||
* (i.e., @FT_IS_VARIATION will return true). If `num_coords` is zero, |
||||
* this bit flag gets unset. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_Var_Design_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Var_Design_Coordinates |
||||
* |
||||
* @description: |
||||
* Get the design coordinates of the currently selected interpolated |
||||
* font. |
||||
* |
||||
* This function works with all supported variation formats. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* num_coords :: |
||||
* The number of design coordinates to retrieve. If it is larger than |
||||
* the number of axes, set the excess values to~0. |
||||
* |
||||
* @output: |
||||
* coords :: |
||||
* The design coordinates array. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The design coordinates are 16.16 fractional values for TrueType GX and |
||||
* OpenType variation fonts. For Adobe MM fonts, the values are whole |
||||
* numbers (i.e., the fractional part is zero). |
||||
* |
||||
* @since: |
||||
* 2.7.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Var_Design_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_MM_Blend_Coordinates |
||||
* |
||||
* @description: |
||||
* Choose an interpolated font design through normalized blend |
||||
* coordinates. |
||||
* |
||||
* This function works with all supported variation formats. |
||||
* |
||||
* @inout: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @input: |
||||
* num_coords :: |
||||
* The number of available design coordinates. If it is larger than |
||||
* the number of axes, ignore the excess values. If it is smaller than |
||||
* the number of axes, use default values for the remaining axes. |
||||
* |
||||
* coords :: |
||||
* The design coordinates array. Each element is a 16.16 fractional |
||||
* value and must be between 0 and 1.0 for Adobe MM fonts, and between |
||||
* -1.0 and 1.0 for TrueType GX and OpenType variation fonts. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* [Since 2.8.1] To reset all axes to the default values, call the |
||||
* function with `num_coords` set to zero and `coords` set to `NULL`. |
||||
* [Since 2.9] 'Default values' means the currently selected named |
||||
* instance (or the base font if no named instance is selected). |
||||
* |
||||
* [Since 2.9] If `num_coords` is larger than zero, this function sets |
||||
* the @FT_FACE_FLAG_VARIATION bit in @FT_Face's `face_flags` field |
||||
* (i.e., @FT_IS_VARIATION will return true). If `num_coords` is zero, |
||||
* this bit flag gets unset. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_MM_Blend_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_MM_Blend_Coordinates |
||||
* |
||||
* @description: |
||||
* Get the normalized blend coordinates of the currently selected |
||||
* interpolated font. |
||||
* |
||||
* This function works with all supported variation formats. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* num_coords :: |
||||
* The number of normalized blend coordinates to retrieve. If it is |
||||
* larger than the number of axes, set the excess values to~0.5 for |
||||
* Adobe MM fonts, and to~0 for TrueType GX and OpenType variation |
||||
* fonts. |
||||
* |
||||
* @output: |
||||
* coords :: |
||||
* The normalized blend coordinates array (as 16.16 fractional values). |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @since: |
||||
* 2.7.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_MM_Blend_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Var_Blend_Coordinates |
||||
* |
||||
* @description: |
||||
* This is another name of @FT_Set_MM_Blend_Coordinates. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_Var_Blend_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Var_Blend_Coordinates |
||||
* |
||||
* @description: |
||||
* This is another name of @FT_Get_MM_Blend_Coordinates. |
||||
* |
||||
* @since: |
||||
* 2.7.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Var_Blend_Coordinates( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_MM_WeightVector |
||||
* |
||||
* @description: |
||||
* For Adobe MM fonts, choose an interpolated font design by directly |
||||
* setting the weight vector. |
||||
* |
||||
* This function can't be used with TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @inout: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @input: |
||||
* len :: |
||||
* The length of the weight vector array. If it is larger than the |
||||
* number of designs, the extra values are ignored. If it is less than |
||||
* the number of designs, the remaining values are set to zero. |
||||
* |
||||
* weightvector :: |
||||
* An array representing the weight vector. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Adobe Multiple Master fonts limit the number of designs, and thus the |
||||
* length of the weight vector to 16~elements. |
||||
* |
||||
* If `len` is larger than zero, this function sets the |
||||
* @FT_FACE_FLAG_VARIATION bit in @FT_Face's `face_flags` field (i.e., |
||||
* @FT_IS_VARIATION will return true). If `len` is zero, this bit flag |
||||
* is unset and the weight vector array is reset to the default values. |
||||
* |
||||
* The Adobe documentation also states that the values in the |
||||
* WeightVector array must total 1.0 +/-~0.001. In practice this does |
||||
* not seem to be enforced, so is not enforced here, either. |
||||
* |
||||
* @since: |
||||
* 2.10 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_MM_WeightVector( FT_Face face, |
||||
FT_UInt len, |
||||
FT_Fixed* weightvector ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_MM_WeightVector |
||||
* |
||||
* @description: |
||||
* For Adobe MM fonts, retrieve the current weight vector of the font. |
||||
* |
||||
* This function can't be used with TrueType GX or OpenType variation |
||||
* fonts. |
||||
* |
||||
* @inout: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* len :: |
||||
* A pointer to the size of the array to be filled. If the size of the |
||||
* array is less than the number of designs, `FT_Err_Invalid_Argument` |
||||
* is returned, and `len` is set to the required size (the number of |
||||
* designs). If the size of the array is greater than the number of |
||||
* designs, the remaining entries are set to~0. On successful |
||||
* completion, `len` is set to the number of designs (i.e., the number |
||||
* of values written to the array). |
||||
* |
||||
* @output: |
||||
* weightvector :: |
||||
* An array to be filled. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Adobe Multiple Master fonts limit the number of designs, and thus the |
||||
* length of the WeightVector to~16. |
||||
* |
||||
* @since: |
||||
* 2.10 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_MM_WeightVector( FT_Face face, |
||||
FT_UInt* len, |
||||
FT_Fixed* weightvector ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_VAR_AXIS_FLAG_XXX |
||||
* |
||||
* @description: |
||||
* A list of bit flags used in the return value of |
||||
* @FT_Get_Var_Axis_Flags. |
||||
* |
||||
* @values: |
||||
* FT_VAR_AXIS_FLAG_HIDDEN :: |
||||
* The variation axis should not be exposed to user interfaces. |
||||
* |
||||
* @since: |
||||
* 2.8.1 |
||||
*/ |
||||
#define FT_VAR_AXIS_FLAG_HIDDEN 1 |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Var_Axis_Flags |
||||
* |
||||
* @description: |
||||
* Get the 'flags' field of an OpenType Variation Axis Record. |
||||
* |
||||
* Not meaningful for Adobe MM fonts (`*flags` is always zero). |
||||
* |
||||
* @input: |
||||
* master :: |
||||
* The variation descriptor. |
||||
* |
||||
* axis_index :: |
||||
* The index of the requested variation axis. |
||||
* |
||||
* @output: |
||||
* flags :: |
||||
* The 'flags' field. See @FT_VAR_AXIS_FLAG_XXX for possible values. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @since: |
||||
* 2.8.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Var_Axis_Flags( FT_MM_Var* master, |
||||
FT_UInt axis_index, |
||||
FT_UInt* flags ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Named_Instance |
||||
* |
||||
* @description: |
||||
* Set or change the current named instance. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* instance_index :: |
||||
* The index of the requested instance, starting with value 1. If set |
||||
* to value 0, FreeType switches to font access without a named |
||||
* instance. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The function uses the value of `instance_index` to set bits 16-30 of |
||||
* the face's `face_index` field. It also resets any variation applied |
||||
* to the font, and the @FT_FACE_FLAG_VARIATION bit of the face's |
||||
* `face_flags` field gets reset to zero (i.e., @FT_IS_VARIATION will |
||||
* return false). |
||||
* |
||||
* For Adobe MM fonts (which don't have named instances) this function |
||||
* simply resets the current face to the default instance. |
||||
* |
||||
* @since: |
||||
* 2.9 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_Named_Instance( FT_Face face, |
||||
FT_UInt instance_index ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Default_Named_Instance |
||||
* |
||||
* @description: |
||||
* Retrieve the index of the default named instance, to be used with |
||||
* @FT_Set_Named_Instance. |
||||
* |
||||
* The default instance of a variation font is that instance for which |
||||
* the nth axis coordinate is equal to `axis[n].def` (as specified in the |
||||
* @FT_MM_Var structure), with~n covering all axes. |
||||
* |
||||
* FreeType synthesizes a named instance for the default instance if the |
||||
* font does not contain such an entry. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @output: |
||||
* instance_index :: |
||||
* The index of the default named instance. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* For Adobe MM fonts (which don't have named instances) this function |
||||
* always returns zero for `instance_index`. |
||||
* |
||||
* @since: |
||||
* 2.13.1 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Default_Named_Instance( FT_Face face, |
||||
FT_UInt *instance_index ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTMM_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,807 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmodapi.h |
||||
* |
||||
* FreeType modules public interface (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMODAPI_H_ |
||||
#define FTMODAPI_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* module_management |
||||
* |
||||
* @title: |
||||
* Module Management |
||||
* |
||||
* @abstract: |
||||
* How to add, upgrade, remove, and control modules from FreeType. |
||||
* |
||||
* @description: |
||||
* The definitions below are used to manage modules within FreeType. |
||||
* Internal and external modules can be added, upgraded, and removed at |
||||
* runtime. For example, an alternative renderer or proprietary font |
||||
* driver can be registered and prioritized. Additionally, some module |
||||
* properties can also be controlled. |
||||
* |
||||
* Here is a list of existing values of the `module_name` field in the |
||||
* @FT_Module_Class structure. |
||||
* |
||||
* ``` |
||||
* autofitter |
||||
* bdf |
||||
* cff |
||||
* gxvalid |
||||
* otvalid |
||||
* pcf |
||||
* pfr |
||||
* psaux |
||||
* pshinter |
||||
* psnames |
||||
* raster1 |
||||
* sfnt |
||||
* smooth |
||||
* truetype |
||||
* type1 |
||||
* type42 |
||||
* t1cid |
||||
* winfonts |
||||
* ``` |
||||
* |
||||
* Note that the FreeType Cache sub-system is not a FreeType module. |
||||
* |
||||
* @order: |
||||
* FT_Module |
||||
* FT_Module_Constructor |
||||
* FT_Module_Destructor |
||||
* FT_Module_Requester |
||||
* FT_Module_Class |
||||
* |
||||
* FT_Add_Module |
||||
* FT_Get_Module |
||||
* FT_Remove_Module |
||||
* FT_Add_Default_Modules |
||||
* |
||||
* FT_FACE_DRIVER_NAME |
||||
* FT_Property_Set |
||||
* FT_Property_Get |
||||
* FT_Set_Default_Properties |
||||
* |
||||
* FT_New_Library |
||||
* FT_Done_Library |
||||
* FT_Reference_Library |
||||
* |
||||
* FT_Renderer |
||||
* FT_Renderer_Class |
||||
* |
||||
* FT_Get_Renderer |
||||
* FT_Set_Renderer |
||||
* |
||||
* FT_Set_Debug_Hook |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* module bit flags */ |
||||
#define FT_MODULE_FONT_DRIVER 1 /* this module is a font driver */ |
||||
#define FT_MODULE_RENDERER 2 /* this module is a renderer */ |
||||
#define FT_MODULE_HINTER 4 /* this module is a glyph hinter */ |
||||
#define FT_MODULE_STYLER 8 /* this module is a styler */ |
||||
|
||||
#define FT_MODULE_DRIVER_SCALABLE 0x100 /* the driver supports */ |
||||
/* scalable fonts */ |
||||
#define FT_MODULE_DRIVER_NO_OUTLINES 0x200 /* the driver does not */ |
||||
/* support vector outlines */ |
||||
#define FT_MODULE_DRIVER_HAS_HINTER 0x400 /* the driver provides its */ |
||||
/* own hinter */ |
||||
#define FT_MODULE_DRIVER_HINTS_LIGHTLY 0x800 /* the driver's hinter */ |
||||
/* produces LIGHT hints */ |
||||
|
||||
|
||||
/* deprecated values */ |
||||
#define ft_module_font_driver FT_MODULE_FONT_DRIVER |
||||
#define ft_module_renderer FT_MODULE_RENDERER |
||||
#define ft_module_hinter FT_MODULE_HINTER |
||||
#define ft_module_styler FT_MODULE_STYLER |
||||
|
||||
#define ft_module_driver_scalable FT_MODULE_DRIVER_SCALABLE |
||||
#define ft_module_driver_no_outlines FT_MODULE_DRIVER_NO_OUTLINES |
||||
#define ft_module_driver_has_hinter FT_MODULE_DRIVER_HAS_HINTER |
||||
#define ft_module_driver_hints_lightly FT_MODULE_DRIVER_HINTS_LIGHTLY |
||||
|
||||
|
||||
typedef FT_Pointer FT_Module_Interface; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Module_Constructor |
||||
* |
||||
* @description: |
||||
* A function used to initialize (not create) a new module object. |
||||
* |
||||
* @input: |
||||
* module :: |
||||
* The module to initialize. |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_Module_Constructor)( FT_Module module ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Module_Destructor |
||||
* |
||||
* @description: |
||||
* A function used to finalize (not destroy) a given module object. |
||||
* |
||||
* @input: |
||||
* module :: |
||||
* The module to finalize. |
||||
*/ |
||||
typedef void |
||||
(*FT_Module_Destructor)( FT_Module module ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Module_Requester |
||||
* |
||||
* @description: |
||||
* A function used to query a given module for a specific interface. |
||||
* |
||||
* @input: |
||||
* module :: |
||||
* The module to be searched. |
||||
* |
||||
* name :: |
||||
* The name of the interface in the module. |
||||
*/ |
||||
typedef FT_Module_Interface |
||||
(*FT_Module_Requester)( FT_Module module, |
||||
const char* name ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Module_Class |
||||
* |
||||
* @description: |
||||
* The module class descriptor. While being a public structure necessary |
||||
* for FreeType's module bookkeeping, most of the fields are essentially |
||||
* internal, not to be used directly by an application. |
||||
* |
||||
* @fields: |
||||
* module_flags :: |
||||
* Bit flags describing the module. |
||||
* |
||||
* module_size :: |
||||
* The size of one module object/instance in bytes. |
||||
* |
||||
* module_name :: |
||||
* The name of the module. |
||||
* |
||||
* module_version :: |
||||
* The version, as a 16.16 fixed number (major.minor). |
||||
* |
||||
* module_requires :: |
||||
* The version of FreeType this module requires, as a 16.16 fixed |
||||
* number (major.minor). Starts at version 2.0, i.e., 0x20000. |
||||
* |
||||
* module_interface :: |
||||
* A typeless pointer to a structure (which varies between different |
||||
* modules) that holds the module's interface functions. This is |
||||
* essentially what `get_interface` returns. |
||||
* |
||||
* module_init :: |
||||
* The initializing function. |
||||
* |
||||
* module_done :: |
||||
* The finalizing function. |
||||
* |
||||
* get_interface :: |
||||
* The interface requesting function. |
||||
*/ |
||||
typedef struct FT_Module_Class_ |
||||
{ |
||||
FT_ULong module_flags; |
||||
FT_Long module_size; |
||||
const FT_String* module_name; |
||||
FT_Fixed module_version; |
||||
FT_Fixed module_requires; |
||||
|
||||
const void* module_interface; |
||||
|
||||
FT_Module_Constructor module_init; |
||||
FT_Module_Destructor module_done; |
||||
FT_Module_Requester get_interface; |
||||
|
||||
} FT_Module_Class; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Add_Module |
||||
* |
||||
* @description: |
||||
* Add a new module to a given library instance. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library object. |
||||
* |
||||
* @input: |
||||
* clazz :: |
||||
* A pointer to class descriptor for the module. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* An error will be returned if a module already exists by that name, or |
||||
* if the module requires a version of FreeType that is too great. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Add_Module( FT_Library library, |
||||
const FT_Module_Class* clazz ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Module |
||||
* |
||||
* @description: |
||||
* Find a module by its name. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the library object. |
||||
* |
||||
* module_name :: |
||||
* The module's name (as an ASCII string). |
||||
* |
||||
* @return: |
||||
* A module handle. 0~if none was found. |
||||
* |
||||
* @note: |
||||
* FreeType's internal modules aren't documented very well, and you |
||||
* should look up the source code for details. |
||||
*/ |
||||
FT_EXPORT( FT_Module ) |
||||
FT_Get_Module( FT_Library library, |
||||
const char* module_name ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Remove_Module |
||||
* |
||||
* @description: |
||||
* Remove a given module from a library instance. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to a library object. |
||||
* |
||||
* @input: |
||||
* module :: |
||||
* A handle to a module object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The module object is destroyed by the function in case of success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Remove_Module( FT_Library library, |
||||
FT_Module module ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FACE_DRIVER_NAME |
||||
* |
||||
* @description: |
||||
* A macro that retrieves the name of a font driver from a face object. |
||||
* |
||||
* @note: |
||||
* The font driver name is a valid `module_name` for @FT_Property_Set |
||||
* and @FT_Property_Get. This is not the same as @FT_Get_Font_Format. |
||||
* |
||||
* @since: |
||||
* 2.11 |
||||
* |
||||
*/ |
||||
#define FT_FACE_DRIVER_NAME( face ) \ |
||||
( ( *FT_REINTERPRET_CAST( FT_Module_Class**, \
|
||||
( face )->driver ) )->module_name ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Property_Set |
||||
* |
||||
* @description: |
||||
* Set a property for a given module. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the library the module is part of. |
||||
* |
||||
* module_name :: |
||||
* The module name. |
||||
* |
||||
* property_name :: |
||||
* The property name. Properties are described in section |
||||
* @properties. |
||||
* |
||||
* Note that only a few modules have properties. |
||||
* |
||||
* value :: |
||||
* A generic pointer to a variable or structure that gives the new |
||||
* value of the property. The exact definition of `value` is |
||||
* dependent on the property; see section @properties. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If `module_name` isn't a valid module name, or `property_name` |
||||
* doesn't specify a valid property, or if `value` doesn't represent a |
||||
* valid value for the given property, an error is returned. |
||||
* |
||||
* The following example sets property 'bar' (a simple integer) in |
||||
* module 'foo' to value~1. |
||||
* |
||||
* ``` |
||||
* FT_UInt bar; |
||||
* |
||||
* |
||||
* bar = 1; |
||||
* FT_Property_Set( library, "foo", "bar", &bar ); |
||||
* ``` |
||||
* |
||||
* Note that the FreeType Cache sub-system doesn't recognize module |
||||
* property changes. To avoid glyph lookup confusion within the cache |
||||
* you should call @FTC_Manager_Reset to completely flush the cache if a |
||||
* module property gets changed after @FTC_Manager_New has been called. |
||||
* |
||||
* It is not possible to set properties of the FreeType Cache sub-system |
||||
* itself with FT_Property_Set; use @FTC_Property_Set instead. |
||||
* |
||||
* @since: |
||||
* 2.4.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Property_Set( FT_Library library, |
||||
const FT_String* module_name, |
||||
const FT_String* property_name, |
||||
const void* value ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Property_Get |
||||
* |
||||
* @description: |
||||
* Get a module's property value. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the library the module is part of. |
||||
* |
||||
* module_name :: |
||||
* The module name. |
||||
* |
||||
* property_name :: |
||||
* The property name. Properties are described in section |
||||
* @properties. |
||||
* |
||||
* @inout: |
||||
* value :: |
||||
* A generic pointer to a variable or structure that gives the value |
||||
* of the property. The exact definition of `value` is dependent on |
||||
* the property; see section @properties. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If `module_name` isn't a valid module name, or `property_name` |
||||
* doesn't specify a valid property, or if `value` doesn't represent a |
||||
* valid value for the given property, an error is returned. |
||||
* |
||||
* The following example gets property 'baz' (a range) in module 'foo'. |
||||
* |
||||
* ``` |
||||
* typedef range_ |
||||
* { |
||||
* FT_Int32 min; |
||||
* FT_Int32 max; |
||||
* |
||||
* } range; |
||||
* |
||||
* range baz; |
||||
* |
||||
* |
||||
* FT_Property_Get( library, "foo", "baz", &baz ); |
||||
* ``` |
||||
* |
||||
* It is not possible to retrieve properties of the FreeType Cache |
||||
* sub-system with FT_Property_Get; use @FTC_Property_Get instead. |
||||
* |
||||
* @since: |
||||
* 2.4.11 |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Property_Get( FT_Library library, |
||||
const FT_String* module_name, |
||||
const FT_String* property_name, |
||||
void* value ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Default_Properties |
||||
* |
||||
* @description: |
||||
* If compilation option `FT_CONFIG_OPTION_ENVIRONMENT_PROPERTIES` is |
||||
* set, this function reads the `FREETYPE_PROPERTIES` environment |
||||
* variable to control driver properties. See section @properties for |
||||
* more. |
||||
* |
||||
* If the compilation option is not set, this function does nothing. |
||||
* |
||||
* `FREETYPE_PROPERTIES` has the following syntax form (broken here into |
||||
* multiple lines for better readability). |
||||
* |
||||
* ``` |
||||
* <optional whitespace> |
||||
* <module-name1> ':' |
||||
* <property-name1> '=' <property-value1> |
||||
* <whitespace> |
||||
* <module-name2> ':' |
||||
* <property-name2> '=' <property-value2> |
||||
* ... |
||||
* ``` |
||||
* |
||||
* Example: |
||||
* |
||||
* ``` |
||||
* FREETYPE_PROPERTIES=truetype:interpreter-version=35 \
|
||||
* cff:no-stem-darkening=0 |
||||
* ``` |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to a new library object. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Set_Default_Properties( FT_Library library ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Reference_Library |
||||
* |
||||
* @description: |
||||
* A counter gets initialized to~1 at the time an @FT_Library structure |
||||
* is created. This function increments the counter. @FT_Done_Library |
||||
* then only destroys a library if the counter is~1, otherwise it simply |
||||
* decrements the counter. |
||||
* |
||||
* This function helps in managing life-cycles of structures that |
||||
* reference @FT_Library objects. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a target library object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @since: |
||||
* 2.4.2 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Reference_Library( FT_Library library ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Library |
||||
* |
||||
* @description: |
||||
* This function is used to create a new FreeType library instance from a |
||||
* given memory object. It is thus possible to use libraries with |
||||
* distinct memory allocators within the same program. Note, however, |
||||
* that the used @FT_Memory structure is expected to remain valid for the |
||||
* life of the @FT_Library object. |
||||
* |
||||
* Normally, you would call this function (followed by a call to |
||||
* @FT_Add_Default_Modules or a series of calls to @FT_Add_Module, and a |
||||
* call to @FT_Set_Default_Properties) instead of @FT_Init_FreeType to |
||||
* initialize the FreeType library. |
||||
* |
||||
* Don't use @FT_Done_FreeType but @FT_Done_Library to destroy a library |
||||
* instance. |
||||
* |
||||
* @input: |
||||
* memory :: |
||||
* A handle to the original memory object. |
||||
* |
||||
* @output: |
||||
* alibrary :: |
||||
* A pointer to handle of a new library object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* See the discussion of reference counters in the description of |
||||
* @FT_Reference_Library. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Library( FT_Memory memory, |
||||
FT_Library *alibrary ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Done_Library |
||||
* |
||||
* @description: |
||||
* Discard a given library object. This closes all drivers and discards |
||||
* all resource objects. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the target library. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* See the discussion of reference counters in the description of |
||||
* @FT_Reference_Library. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Done_Library( FT_Library library ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_DebugHook_Func |
||||
* |
||||
* @description: |
||||
* A drop-in replacement (or rather a wrapper) for the bytecode or |
||||
* charstring interpreter's main loop function. |
||||
* |
||||
* Its job is essentially |
||||
* |
||||
* - to activate debug mode to enforce single-stepping, |
||||
* |
||||
* - to call the main loop function to interpret the next opcode, and |
||||
* |
||||
* - to show the changed context to the user. |
||||
* |
||||
* An example for such a main loop function is `TT_RunIns` (declared in |
||||
* FreeType's internal header file `src/truetype/ttinterp.h`). |
||||
* |
||||
* Have a look at the source code of the `ttdebug` FreeType demo program |
||||
* for an example of a drop-in replacement. |
||||
* |
||||
* @inout: |
||||
* arg :: |
||||
* A typeless pointer, to be cast to the main loop function's data |
||||
* structure (which depends on the font module). For TrueType fonts |
||||
* it is bytecode interpreter's execution context, `TT_ExecContext`, |
||||
* which is declared in FreeType's internal header file `tttypes.h`. |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_DebugHook_Func)( void* arg ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_DEBUG_HOOK_XXX |
||||
* |
||||
* @description: |
||||
* A list of named debug hook indices. |
||||
* |
||||
* @values: |
||||
* FT_DEBUG_HOOK_TRUETYPE:: |
||||
* This hook index identifies the TrueType bytecode debugger. |
||||
*/ |
||||
#define FT_DEBUG_HOOK_TRUETYPE 0 |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Debug_Hook |
||||
* |
||||
* @description: |
||||
* Set a debug hook function for debugging the interpreter of a font |
||||
* format. |
||||
* |
||||
* While this is a public API function, an application needs access to |
||||
* FreeType's internal header files to do something useful. |
||||
* |
||||
* Have a look at the source code of the `ttdebug` FreeType demo program |
||||
* for an example of its usage. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library object. |
||||
* |
||||
* @input: |
||||
* hook_index :: |
||||
* The index of the debug hook. You should use defined enumeration |
||||
* macros like @FT_DEBUG_HOOK_TRUETYPE. |
||||
* |
||||
* debug_hook :: |
||||
* The function used to debug the interpreter. |
||||
* |
||||
* @note: |
||||
* Currently, four debug hook slots are available, but only one (for the |
||||
* TrueType interpreter) is defined. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Set_Debug_Hook( FT_Library library, |
||||
FT_UInt hook_index, |
||||
FT_DebugHook_Func debug_hook ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Add_Default_Modules |
||||
* |
||||
* @description: |
||||
* Add the set of default drivers to a given library object. This is |
||||
* only useful when you create a library object with @FT_New_Library |
||||
* (usually to plug a custom memory manager). |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to a new library object. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Add_Default_Modules( FT_Library library ); |
||||
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* truetype_engine |
||||
* |
||||
* @title: |
||||
* The TrueType Engine |
||||
* |
||||
* @abstract: |
||||
* TrueType bytecode support. |
||||
* |
||||
* @description: |
||||
* This section contains a function used to query the level of TrueType |
||||
* bytecode support compiled in this version of the library. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_TrueTypeEngineType |
||||
* |
||||
* @description: |
||||
* A list of values describing which kind of TrueType bytecode engine is |
||||
* implemented in a given FT_Library instance. It is used by the |
||||
* @FT_Get_TrueType_Engine_Type function. |
||||
* |
||||
* @values: |
||||
* FT_TRUETYPE_ENGINE_TYPE_NONE :: |
||||
* The library doesn't implement any kind of bytecode interpreter. |
||||
* |
||||
* FT_TRUETYPE_ENGINE_TYPE_UNPATENTED :: |
||||
* Deprecated and removed. |
||||
* |
||||
* FT_TRUETYPE_ENGINE_TYPE_PATENTED :: |
||||
* The library implements a bytecode interpreter that covers the full |
||||
* instruction set of the TrueType virtual machine (this was governed |
||||
* by patents until May 2010, hence the name). |
||||
* |
||||
* @since: |
||||
* 2.2 |
||||
* |
||||
*/ |
||||
typedef enum FT_TrueTypeEngineType_ |
||||
{ |
||||
FT_TRUETYPE_ENGINE_TYPE_NONE = 0, |
||||
FT_TRUETYPE_ENGINE_TYPE_UNPATENTED, |
||||
FT_TRUETYPE_ENGINE_TYPE_PATENTED |
||||
|
||||
} FT_TrueTypeEngineType; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_TrueType_Engine_Type |
||||
* |
||||
* @description: |
||||
* Return an @FT_TrueTypeEngineType value to indicate which level of the |
||||
* TrueType virtual machine a given library instance supports. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A library instance. |
||||
* |
||||
* @return: |
||||
* A value indicating which level is supported. |
||||
* |
||||
* @since: |
||||
* 2.2 |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_TrueTypeEngineType ) |
||||
FT_Get_TrueType_Engine_Type( FT_Library library ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTMODAPI_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,204 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmoderr.h |
||||
* |
||||
* FreeType module error offsets (specification). |
||||
* |
||||
* Copyright (C) 2001-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This file is used to define the FreeType module error codes. |
||||
* |
||||
* If the macro `FT_CONFIG_OPTION_USE_MODULE_ERRORS` in `ftoption.h` is |
||||
* set, the lower byte of an error value identifies the error code as |
||||
* usual. In addition, the higher byte identifies the module. For |
||||
* example, the error `FT_Err_Invalid_File_Format` has value 0x0003, the |
||||
* error `TT_Err_Invalid_File_Format` has value 0x1303, the error |
||||
* `T1_Err_Invalid_File_Format` has value 0x1403, etc. |
||||
* |
||||
* Note that `FT_Err_Ok`, `TT_Err_Ok`, etc. are always equal to zero, |
||||
* including the high byte. |
||||
* |
||||
* If `FT_CONFIG_OPTION_USE_MODULE_ERRORS` isn't set, the higher byte of an |
||||
* error value is set to zero. |
||||
* |
||||
* To hide the various `XXX_Err_` prefixes in the source code, FreeType |
||||
* provides some macros in `fttypes.h`. |
||||
* |
||||
* FT_ERR( err ) |
||||
* |
||||
* Add current error module prefix (as defined with the `FT_ERR_PREFIX` |
||||
* macro) to `err`. For example, in the BDF module the line |
||||
* |
||||
* ``` |
||||
* error = FT_ERR( Invalid_Outline ); |
||||
* ``` |
||||
* |
||||
* expands to |
||||
* |
||||
* ``` |
||||
* error = BDF_Err_Invalid_Outline; |
||||
* ``` |
||||
* |
||||
* For simplicity, you can always use `FT_Err_Ok` directly instead of |
||||
* `FT_ERR( Ok )`. |
||||
* |
||||
* FT_ERR_EQ( errcode, err ) |
||||
* FT_ERR_NEQ( errcode, err ) |
||||
* |
||||
* Compare error code `errcode` with the error `err` for equality and |
||||
* inequality, respectively. Example: |
||||
* |
||||
* ``` |
||||
* if ( FT_ERR_EQ( error, Invalid_Outline ) ) |
||||
* ... |
||||
* ``` |
||||
* |
||||
* Using this macro you don't have to think about error prefixes. Of |
||||
* course, if module errors are not active, the above example is the |
||||
* same as |
||||
* |
||||
* ``` |
||||
* if ( error == FT_Err_Invalid_Outline ) |
||||
* ... |
||||
* ``` |
||||
* |
||||
* FT_ERROR_BASE( errcode ) |
||||
* FT_ERROR_MODULE( errcode ) |
||||
* |
||||
* Get base error and module error code, respectively. |
||||
* |
||||
* It can also be used to create a module error message table easily with |
||||
* something like |
||||
* |
||||
* ``` |
||||
* #undef FTMODERR_H_ |
||||
* #define FT_MODERRDEF( e, v, s ) { FT_Mod_Err_ ## e, s }, |
||||
* #define FT_MODERR_START_LIST { |
||||
* #define FT_MODERR_END_LIST { 0, 0 } }; |
||||
* |
||||
* const struct |
||||
* { |
||||
* int mod_err_offset; |
||||
* const char* mod_err_msg |
||||
* } ft_mod_errors[] = |
||||
* |
||||
* #include <freetype/ftmoderr.h> |
||||
* ``` |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMODERR_H_ |
||||
#define FTMODERR_H_ |
||||
|
||||
|
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
/***** *****/ |
||||
/***** SETUP MACROS *****/ |
||||
/***** *****/ |
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
|
||||
|
||||
#undef FT_NEED_EXTERN_C |
||||
|
||||
#ifndef FT_MODERRDEF |
||||
|
||||
#ifdef FT_CONFIG_OPTION_USE_MODULE_ERRORS |
||||
#define FT_MODERRDEF( e, v, s ) FT_Mod_Err_ ## e = v, |
||||
#else |
||||
#define FT_MODERRDEF( e, v, s ) FT_Mod_Err_ ## e = 0, |
||||
#endif |
||||
|
||||
#define FT_MODERR_START_LIST enum { |
||||
#define FT_MODERR_END_LIST FT_Mod_Err_Max }; |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_NEED_EXTERN_C |
||||
extern "C" { |
||||
#endif |
||||
|
||||
#endif /* !FT_MODERRDEF */ |
||||
|
||||
|
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
/***** *****/ |
||||
/***** LIST MODULE ERROR BASES *****/ |
||||
/***** *****/ |
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
|
||||
|
||||
#ifdef FT_MODERR_START_LIST |
||||
FT_MODERR_START_LIST |
||||
#endif |
||||
|
||||
|
||||
FT_MODERRDEF( Base, 0x000, "base module" ) |
||||
FT_MODERRDEF( Autofit, 0x100, "autofitter module" ) |
||||
FT_MODERRDEF( BDF, 0x200, "BDF module" ) |
||||
FT_MODERRDEF( Bzip2, 0x300, "Bzip2 module" ) |
||||
FT_MODERRDEF( Cache, 0x400, "cache module" ) |
||||
FT_MODERRDEF( CFF, 0x500, "CFF module" ) |
||||
FT_MODERRDEF( CID, 0x600, "CID module" ) |
||||
FT_MODERRDEF( Gzip, 0x700, "Gzip module" ) |
||||
FT_MODERRDEF( LZW, 0x800, "LZW module" ) |
||||
FT_MODERRDEF( OTvalid, 0x900, "OpenType validation module" ) |
||||
FT_MODERRDEF( PCF, 0xA00, "PCF module" ) |
||||
FT_MODERRDEF( PFR, 0xB00, "PFR module" ) |
||||
FT_MODERRDEF( PSaux, 0xC00, "PS auxiliary module" ) |
||||
FT_MODERRDEF( PShinter, 0xD00, "PS hinter module" ) |
||||
FT_MODERRDEF( PSnames, 0xE00, "PS names module" ) |
||||
FT_MODERRDEF( Raster, 0xF00, "raster module" ) |
||||
FT_MODERRDEF( SFNT, 0x1000, "SFNT module" ) |
||||
FT_MODERRDEF( Smooth, 0x1100, "smooth raster module" ) |
||||
FT_MODERRDEF( TrueType, 0x1200, "TrueType module" ) |
||||
FT_MODERRDEF( Type1, 0x1300, "Type 1 module" ) |
||||
FT_MODERRDEF( Type42, 0x1400, "Type 42 module" ) |
||||
FT_MODERRDEF( Winfonts, 0x1500, "Windows FON/FNT module" ) |
||||
FT_MODERRDEF( GXvalid, 0x1600, "GX validation module" ) |
||||
FT_MODERRDEF( Sdf, 0x1700, "Signed distance field raster module" ) |
||||
|
||||
|
||||
#ifdef FT_MODERR_END_LIST |
||||
FT_MODERR_END_LIST |
||||
#endif |
||||
|
||||
|
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
/***** *****/ |
||||
/***** CLEANUP *****/ |
||||
/***** *****/ |
||||
/*******************************************************************/ |
||||
/*******************************************************************/ |
||||
|
||||
|
||||
#ifdef FT_NEED_EXTERN_C |
||||
} |
||||
#endif |
||||
|
||||
#undef FT_MODERR_START_LIST |
||||
#undef FT_MODERR_END_LIST |
||||
#undef FT_MODERRDEF |
||||
#undef FT_NEED_EXTERN_C |
||||
|
||||
|
||||
#endif /* FTMODERR_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,206 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftotval.h |
||||
* |
||||
* FreeType API for validating OpenType tables (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/****************************************************************************
|
||||
* |
||||
* |
||||
* Warning: This module might be moved to a different library in the |
||||
* future to avoid a tight dependency between FreeType and the |
||||
* OpenType specification. |
||||
* |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTOTVAL_H_ |
||||
#define FTOTVAL_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* ot_validation |
||||
* |
||||
* @title: |
||||
* OpenType Validation |
||||
* |
||||
* @abstract: |
||||
* An API to validate OpenType tables. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of functions to validate some |
||||
* OpenType tables (BASE, GDEF, GPOS, GSUB, JSTF, MATH). |
||||
* |
||||
* @order: |
||||
* FT_OpenType_Validate |
||||
* FT_OpenType_Free |
||||
* |
||||
* FT_VALIDATE_OTXXX |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_VALIDATE_OTXXX |
||||
* |
||||
* @description: |
||||
* A list of bit-field constants used with @FT_OpenType_Validate to |
||||
* indicate which OpenType tables should be validated. |
||||
* |
||||
* @values: |
||||
* FT_VALIDATE_BASE :: |
||||
* Validate BASE table. |
||||
* |
||||
* FT_VALIDATE_GDEF :: |
||||
* Validate GDEF table. |
||||
* |
||||
* FT_VALIDATE_GPOS :: |
||||
* Validate GPOS table. |
||||
* |
||||
* FT_VALIDATE_GSUB :: |
||||
* Validate GSUB table. |
||||
* |
||||
* FT_VALIDATE_JSTF :: |
||||
* Validate JSTF table. |
||||
* |
||||
* FT_VALIDATE_MATH :: |
||||
* Validate MATH table. |
||||
* |
||||
* FT_VALIDATE_OT :: |
||||
* Validate all OpenType tables (BASE, GDEF, GPOS, GSUB, JSTF, MATH). |
||||
* |
||||
*/ |
||||
#define FT_VALIDATE_BASE 0x0100 |
||||
#define FT_VALIDATE_GDEF 0x0200 |
||||
#define FT_VALIDATE_GPOS 0x0400 |
||||
#define FT_VALIDATE_GSUB 0x0800 |
||||
#define FT_VALIDATE_JSTF 0x1000 |
||||
#define FT_VALIDATE_MATH 0x2000 |
||||
|
||||
#define FT_VALIDATE_OT ( FT_VALIDATE_BASE | \ |
||||
FT_VALIDATE_GDEF | \
|
||||
FT_VALIDATE_GPOS | \
|
||||
FT_VALIDATE_GSUB | \
|
||||
FT_VALIDATE_JSTF | \
|
||||
FT_VALIDATE_MATH ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_OpenType_Validate |
||||
* |
||||
* @description: |
||||
* Validate various OpenType tables to assure that all offsets and |
||||
* indices are valid. The idea is that a higher-level library that |
||||
* actually does the text layout can access those tables without error |
||||
* checking (which can be quite time consuming). |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* validation_flags :: |
||||
* A bit field that specifies the tables to be validated. See |
||||
* @FT_VALIDATE_OTXXX for possible values. |
||||
* |
||||
* @output: |
||||
* BASE_table :: |
||||
* A pointer to the BASE table. |
||||
* |
||||
* GDEF_table :: |
||||
* A pointer to the GDEF table. |
||||
* |
||||
* GPOS_table :: |
||||
* A pointer to the GPOS table. |
||||
* |
||||
* GSUB_table :: |
||||
* A pointer to the GSUB table. |
||||
* |
||||
* JSTF_table :: |
||||
* A pointer to the JSTF table. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with OpenType fonts, returning an error |
||||
* otherwise. |
||||
* |
||||
* After use, the application should deallocate the five tables with |
||||
* @FT_OpenType_Free. A `NULL` value indicates that the table either |
||||
* doesn't exist in the font, or the application hasn't asked for |
||||
* validation. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_OpenType_Validate( FT_Face face, |
||||
FT_UInt validation_flags, |
||||
FT_Bytes *BASE_table, |
||||
FT_Bytes *GDEF_table, |
||||
FT_Bytes *GPOS_table, |
||||
FT_Bytes *GSUB_table, |
||||
FT_Bytes *JSTF_table ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_OpenType_Free |
||||
* |
||||
* @description: |
||||
* Free the buffer allocated by OpenType validator. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* table :: |
||||
* The pointer to the buffer that is allocated by |
||||
* @FT_OpenType_Validate. |
||||
* |
||||
* @note: |
||||
* This function must be used to free the buffer allocated by |
||||
* @FT_OpenType_Validate only. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_OpenType_Free( FT_Face face, |
||||
FT_Bytes table ); |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTOTVAL_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,588 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftoutln.h |
||||
* |
||||
* Support for the FT_Outline type used to store glyph shapes of |
||||
* most scalable font formats (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTOUTLN_H_ |
||||
#define FTOUTLN_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* outline_processing |
||||
* |
||||
* @title: |
||||
* Outline Processing |
||||
* |
||||
* @abstract: |
||||
* Functions to create, transform, and render vectorial glyph images. |
||||
* |
||||
* @description: |
||||
* This section contains routines used to create and destroy scalable |
||||
* glyph images known as 'outlines'. These can also be measured, |
||||
* transformed, and converted into bitmaps and pixmaps. |
||||
* |
||||
* @order: |
||||
* FT_Outline |
||||
* FT_Outline_New |
||||
* FT_Outline_Done |
||||
* FT_Outline_Copy |
||||
* FT_Outline_Translate |
||||
* FT_Outline_Transform |
||||
* FT_Outline_Embolden |
||||
* FT_Outline_EmboldenXY |
||||
* FT_Outline_Reverse |
||||
* FT_Outline_Check |
||||
* |
||||
* FT_Outline_Get_CBox |
||||
* FT_Outline_Get_BBox |
||||
* |
||||
* FT_Outline_Get_Bitmap |
||||
* FT_Outline_Render |
||||
* FT_Outline_Decompose |
||||
* FT_Outline_Funcs |
||||
* FT_Outline_MoveToFunc |
||||
* FT_Outline_LineToFunc |
||||
* FT_Outline_ConicToFunc |
||||
* FT_Outline_CubicToFunc |
||||
* |
||||
* FT_Orientation |
||||
* FT_Outline_Get_Orientation |
||||
* |
||||
* FT_OUTLINE_XXX |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Decompose |
||||
* |
||||
* @description: |
||||
* Walk over an outline's structure to decompose it into individual |
||||
* segments and Bezier arcs. This function also emits 'move to' |
||||
* operations to indicate the start of new contours in the outline. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* A pointer to the source target. |
||||
* |
||||
* func_interface :: |
||||
* A table of 'emitters', i.e., function pointers called during |
||||
* decomposition to indicate path operations. |
||||
* |
||||
* @inout: |
||||
* user :: |
||||
* A typeless pointer that is passed to each emitter during the |
||||
* decomposition. It can be used to store the state during the |
||||
* decomposition. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* Degenerate contours, segments, and Bezier arcs may be reported. In |
||||
* most cases, it is best to filter these out before using the outline |
||||
* for stroking or other path modification purposes (which may cause |
||||
* degenerate segments to become non-degenrate and visible, like when |
||||
* stroke caps are used or the path is otherwise outset). Some glyph |
||||
* outlines may contain deliberate degenerate single points for mark |
||||
* attachement. |
||||
* |
||||
* Similarly, the function returns success for an empty outline also |
||||
* (doing nothing, that is, not calling any emitter); if necessary, you |
||||
* should filter this out, too. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Decompose( FT_Outline* outline, |
||||
const FT_Outline_Funcs* func_interface, |
||||
void* user ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_New |
||||
* |
||||
* @description: |
||||
* Create a new outline of a given size. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the library object from where the outline is allocated. |
||||
* Note however that the new outline will **not** necessarily be |
||||
* **freed**, when destroying the library, by @FT_Done_FreeType. |
||||
* |
||||
* numPoints :: |
||||
* The maximum number of points within the outline. Must be smaller |
||||
* than or equal to 0xFFFF (65535). |
||||
* |
||||
* numContours :: |
||||
* The maximum number of contours within the outline. This value must |
||||
* be in the range 0 to `numPoints`. |
||||
* |
||||
* @output: |
||||
* anoutline :: |
||||
* A handle to the new outline. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The reason why this function takes a `library` parameter is simply to |
||||
* use the library's memory allocator. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_New( FT_Library library, |
||||
FT_UInt numPoints, |
||||
FT_Int numContours, |
||||
FT_Outline *anoutline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Done |
||||
* |
||||
* @description: |
||||
* Destroy an outline created with @FT_Outline_New. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle of the library object used to allocate the outline. |
||||
* |
||||
* outline :: |
||||
* A pointer to the outline object to be discarded. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If the outline's 'owner' field is not set, only the outline descriptor |
||||
* will be released. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Done( FT_Library library, |
||||
FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Check |
||||
* |
||||
* @description: |
||||
* Check the contents of an outline descriptor. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* A handle to a source outline. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* An empty outline, or an outline with a single point only is also |
||||
* valid. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Check( FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Get_CBox |
||||
* |
||||
* @description: |
||||
* Return an outline's 'control box'. The control box encloses all the |
||||
* outline's points, including Bezier control points. Though it |
||||
* coincides with the exact bounding box for most glyphs, it can be |
||||
* slightly larger in some situations (like when rotating an outline that |
||||
* contains Bezier outside arcs). |
||||
* |
||||
* Computing the control box is very fast, while getting the bounding box |
||||
* can take much more time as it needs to walk over all segments and arcs |
||||
* in the outline. To get the latter, you can use the 'ftbbox' |
||||
* component, which is dedicated to this single task. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* A pointer to the source outline descriptor. |
||||
* |
||||
* @output: |
||||
* acbox :: |
||||
* The outline's control box. |
||||
* |
||||
* @note: |
||||
* See @FT_Glyph_Get_CBox for a discussion of tricky fonts. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Outline_Get_CBox( const FT_Outline* outline, |
||||
FT_BBox *acbox ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Translate |
||||
* |
||||
* @description: |
||||
* Apply a simple translation to the points of an outline. |
||||
* |
||||
* @inout: |
||||
* outline :: |
||||
* A pointer to the target outline descriptor. |
||||
* |
||||
* @input: |
||||
* xOffset :: |
||||
* The horizontal offset. |
||||
* |
||||
* yOffset :: |
||||
* The vertical offset. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Outline_Translate( const FT_Outline* outline, |
||||
FT_Pos xOffset, |
||||
FT_Pos yOffset ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Copy |
||||
* |
||||
* @description: |
||||
* Copy an outline into another one. Both objects must have the same |
||||
* sizes (number of points & number of contours) when this function is |
||||
* called. |
||||
* |
||||
* @input: |
||||
* source :: |
||||
* A handle to the source outline. |
||||
* |
||||
* @output: |
||||
* target :: |
||||
* A handle to the target outline. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Copy( const FT_Outline* source, |
||||
FT_Outline *target ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Transform |
||||
* |
||||
* @description: |
||||
* Apply a simple 2x2 matrix to all of an outline's points. Useful for |
||||
* applying rotations, slanting, flipping, etc. |
||||
* |
||||
* @inout: |
||||
* outline :: |
||||
* A pointer to the target outline descriptor. |
||||
* |
||||
* @input: |
||||
* matrix :: |
||||
* A pointer to the transformation matrix. |
||||
* |
||||
* @note: |
||||
* You can use @FT_Outline_Translate if you need to translate the |
||||
* outline's points. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Outline_Transform( const FT_Outline* outline, |
||||
const FT_Matrix* matrix ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Embolden |
||||
* |
||||
* @description: |
||||
* Embolden an outline. The new outline will be at most 4~times |
||||
* `strength` pixels wider and higher. You may think of the left and |
||||
* bottom borders as unchanged. |
||||
* |
||||
* Negative `strength` values to reduce the outline thickness are |
||||
* possible also. |
||||
* |
||||
* @inout: |
||||
* outline :: |
||||
* A handle to the target outline. |
||||
* |
||||
* @input: |
||||
* strength :: |
||||
* How strong the glyph is emboldened. Expressed in 26.6 pixel format. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The used algorithm to increase or decrease the thickness of the glyph |
||||
* doesn't change the number of points; this means that certain |
||||
* situations like acute angles or intersections are sometimes handled |
||||
* incorrectly. |
||||
* |
||||
* If you need 'better' metrics values you should call |
||||
* @FT_Outline_Get_CBox or @FT_Outline_Get_BBox. |
||||
* |
||||
* To get meaningful results, font scaling values must be set with |
||||
* functions like @FT_Set_Char_Size before calling FT_Render_Glyph. |
||||
* |
||||
* @example: |
||||
* ``` |
||||
* FT_Load_Glyph( face, index, FT_LOAD_DEFAULT ); |
||||
* |
||||
* if ( face->glyph->format == FT_GLYPH_FORMAT_OUTLINE ) |
||||
* FT_Outline_Embolden( &face->glyph->outline, strength ); |
||||
* ``` |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Embolden( FT_Outline* outline, |
||||
FT_Pos strength ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_EmboldenXY |
||||
* |
||||
* @description: |
||||
* Embolden an outline. The new outline will be `xstrength` pixels wider |
||||
* and `ystrength` pixels higher. Otherwise, it is similar to |
||||
* @FT_Outline_Embolden, which uses the same strength in both directions. |
||||
* |
||||
* @since: |
||||
* 2.4.10 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_EmboldenXY( FT_Outline* outline, |
||||
FT_Pos xstrength, |
||||
FT_Pos ystrength ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Reverse |
||||
* |
||||
* @description: |
||||
* Reverse the drawing direction of an outline. This is used to ensure |
||||
* consistent fill conventions for mirrored glyphs. |
||||
* |
||||
* @inout: |
||||
* outline :: |
||||
* A pointer to the target outline descriptor. |
||||
* |
||||
* @note: |
||||
* This function toggles the bit flag @FT_OUTLINE_REVERSE_FILL in the |
||||
* outline's `flags` field. |
||||
* |
||||
* It shouldn't be used by a normal client application, unless it knows |
||||
* what it is doing. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Outline_Reverse( FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Get_Bitmap |
||||
* |
||||
* @description: |
||||
* Render an outline within a bitmap. The outline's image is simply |
||||
* OR-ed to the target bitmap. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a FreeType library object. |
||||
* |
||||
* outline :: |
||||
* A pointer to the source outline descriptor. |
||||
* |
||||
* @inout: |
||||
* abitmap :: |
||||
* A pointer to the target bitmap descriptor. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function does **not create** the bitmap, it only renders an |
||||
* outline image within the one you pass to it! Consequently, the |
||||
* various fields in `abitmap` should be set accordingly. |
||||
* |
||||
* It will use the raster corresponding to the default glyph format. |
||||
* |
||||
* The value of the `num_grays` field in `abitmap` is ignored. If you |
||||
* select the gray-level rasterizer, and you want less than 256 gray |
||||
* levels, you have to use @FT_Outline_Render directly. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Get_Bitmap( FT_Library library, |
||||
FT_Outline* outline, |
||||
const FT_Bitmap *abitmap ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Render |
||||
* |
||||
* @description: |
||||
* Render an outline within a bitmap using the current scan-convert. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to a FreeType library object. |
||||
* |
||||
* outline :: |
||||
* A pointer to the source outline descriptor. |
||||
* |
||||
* @inout: |
||||
* params :: |
||||
* A pointer to an @FT_Raster_Params structure used to describe the |
||||
* rendering operation. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This advanced function uses @FT_Raster_Params as an argument. |
||||
* The field `params.source` will be set to `outline` before the scan |
||||
* converter is called, which means that the value you give to it is |
||||
* actually ignored. Either `params.target` must point to preallocated |
||||
* bitmap, or @FT_RASTER_FLAG_DIRECT must be set in `params.flags` |
||||
* allowing FreeType rasterizer to be used for direct composition, |
||||
* translucency, etc. See @FT_Raster_Params for more details. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Outline_Render( FT_Library library, |
||||
FT_Outline* outline, |
||||
FT_Raster_Params* params ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_Orientation |
||||
* |
||||
* @description: |
||||
* A list of values used to describe an outline's contour orientation. |
||||
* |
||||
* The TrueType and PostScript specifications use different conventions |
||||
* to determine whether outline contours should be filled or unfilled. |
||||
* |
||||
* @values: |
||||
* FT_ORIENTATION_TRUETYPE :: |
||||
* According to the TrueType specification, clockwise contours must be |
||||
* filled, and counter-clockwise ones must be unfilled. |
||||
* |
||||
* FT_ORIENTATION_POSTSCRIPT :: |
||||
* According to the PostScript specification, counter-clockwise |
||||
* contours must be filled, and clockwise ones must be unfilled. |
||||
* |
||||
* FT_ORIENTATION_FILL_RIGHT :: |
||||
* This is identical to @FT_ORIENTATION_TRUETYPE, but is used to |
||||
* remember that in TrueType, everything that is to the right of the |
||||
* drawing direction of a contour must be filled. |
||||
* |
||||
* FT_ORIENTATION_FILL_LEFT :: |
||||
* This is identical to @FT_ORIENTATION_POSTSCRIPT, but is used to |
||||
* remember that in PostScript, everything that is to the left of the |
||||
* drawing direction of a contour must be filled. |
||||
* |
||||
* FT_ORIENTATION_NONE :: |
||||
* The orientation cannot be determined. That is, different parts of |
||||
* the glyph have different orientation. |
||||
* |
||||
*/ |
||||
typedef enum FT_Orientation_ |
||||
{ |
||||
FT_ORIENTATION_TRUETYPE = 0, |
||||
FT_ORIENTATION_POSTSCRIPT = 1, |
||||
FT_ORIENTATION_FILL_RIGHT = FT_ORIENTATION_TRUETYPE, |
||||
FT_ORIENTATION_FILL_LEFT = FT_ORIENTATION_POSTSCRIPT, |
||||
FT_ORIENTATION_NONE |
||||
|
||||
} FT_Orientation; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_Get_Orientation |
||||
* |
||||
* @description: |
||||
* This function analyzes a glyph outline and tries to compute its fill |
||||
* orientation (see @FT_Orientation). This is done by integrating the |
||||
* total area covered by the outline. The positive integral corresponds |
||||
* to the clockwise orientation and @FT_ORIENTATION_POSTSCRIPT is |
||||
* returned. The negative integral corresponds to the counter-clockwise |
||||
* orientation and @FT_ORIENTATION_TRUETYPE is returned. |
||||
* |
||||
* Note that this will return @FT_ORIENTATION_TRUETYPE for empty |
||||
* outlines. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* A handle to the source outline. |
||||
* |
||||
* @return: |
||||
* The orientation. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Orientation ) |
||||
FT_Outline_Get_Orientation( FT_Outline* outline ); |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTOUTLN_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
|
||||
|
||||
/* Local Variables: */ |
||||
/* coding: utf-8 */ |
||||
/* End: */ |
||||
@ -0,0 +1,218 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftparams.h |
||||
* |
||||
* FreeType API for possible FT_Parameter tags (specification only). |
||||
* |
||||
* Copyright (C) 2017-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTPARAMS_H_ |
||||
#define FTPARAMS_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* parameter_tags |
||||
* |
||||
* @title: |
||||
* Parameter Tags |
||||
* |
||||
* @abstract: |
||||
* Macros for driver property and font loading parameter tags. |
||||
* |
||||
* @description: |
||||
* This section contains macros for the @FT_Parameter structure that are |
||||
* used with various functions to activate some special functionality or |
||||
* different behaviour of various components of FreeType. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY |
||||
* |
||||
* @description: |
||||
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic |
||||
* family names in the 'name' table (introduced in OpenType version 1.4). |
||||
* Use this for backward compatibility with legacy systems that have a |
||||
* four-faces-per-family restriction. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY \ |
||||
FT_MAKE_TAG( 'i', 'g', 'p', 'f' ) |
||||
|
||||
|
||||
/* this constant is deprecated */ |
||||
#define FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY \ |
||||
FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY |
||||
* |
||||
* @description: |
||||
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic |
||||
* subfamily names in the 'name' table (introduced in OpenType version |
||||
* 1.4). Use this for backward compatibility with legacy systems that |
||||
* have a four-faces-per-family restriction. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY \ |
||||
FT_MAKE_TAG( 'i', 'g', 'p', 's' ) |
||||
|
||||
|
||||
/* this constant is deprecated */ |
||||
#define FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY \ |
||||
FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_INCREMENTAL |
||||
* |
||||
* @description: |
||||
* An @FT_Parameter tag to be used with @FT_Open_Face to indicate |
||||
* incremental glyph loading. |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_INCREMENTAL \ |
||||
FT_MAKE_TAG( 'i', 'n', 'c', 'r' ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_IGNORE_SBIX |
||||
* |
||||
* @description: |
||||
* A tag for @FT_Parameter to make @FT_Open_Face ignore an 'sbix' table |
||||
* while loading a font. Use this if @FT_FACE_FLAG_SBIX is set and you |
||||
* want to access the outline glyphs in the font. |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_IGNORE_SBIX \ |
||||
FT_MAKE_TAG( 'i', 's', 'b', 'x' ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_LCD_FILTER_WEIGHTS |
||||
* |
||||
* @description: |
||||
* An @FT_Parameter tag to be used with @FT_Face_Properties. The |
||||
* corresponding argument specifies the five LCD filter weights for a |
||||
* given face (if using @FT_LOAD_TARGET_LCD, for example), overriding the |
||||
* global default values or the values set up with |
||||
* @FT_Library_SetLcdFilterWeights. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_LCD_FILTER_WEIGHTS \ |
||||
FT_MAKE_TAG( 'l', 'c', 'd', 'f' ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_RANDOM_SEED |
||||
* |
||||
* @description: |
||||
* An @FT_Parameter tag to be used with @FT_Face_Properties. The |
||||
* corresponding 32bit signed integer argument overrides the font |
||||
* driver's random seed value with a face-specific one; see @random-seed. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_RANDOM_SEED \ |
||||
FT_MAKE_TAG( 's', 'e', 'e', 'd' ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_STEM_DARKENING |
||||
* |
||||
* @description: |
||||
* An @FT_Parameter tag to be used with @FT_Face_Properties. The |
||||
* corresponding Boolean argument specifies whether to apply stem |
||||
* darkening, overriding the global default values or the values set up |
||||
* with @FT_Property_Set (see @no-stem-darkening). |
||||
* |
||||
* This is a passive setting that only takes effect if the font driver or |
||||
* autohinter honors it, which the CFF, Type~1, and CID drivers always |
||||
* do, but the autohinter only in 'light' hinting mode (as of version |
||||
* 2.9). |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_STEM_DARKENING \ |
||||
FT_MAKE_TAG( 'd', 'a', 'r', 'k' ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_PARAM_TAG_UNPATENTED_HINTING |
||||
* |
||||
* @description: |
||||
* Deprecated, no effect. |
||||
* |
||||
* Previously: A constant used as the tag of an @FT_Parameter structure |
||||
* to indicate that unpatented methods only should be used by the |
||||
* TrueType bytecode interpreter for a typeface opened by @FT_Open_Face. |
||||
* |
||||
*/ |
||||
#define FT_PARAM_TAG_UNPATENTED_HINTING \ |
||||
FT_MAKE_TAG( 'u', 'n', 'p', 'a' ) |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FTPARAMS_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,179 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftpfr.h |
||||
* |
||||
* FreeType API for accessing PFR-specific data (specification only). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTPFR_H_ |
||||
#define FTPFR_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* pfr_fonts |
||||
* |
||||
* @title: |
||||
* PFR Fonts |
||||
* |
||||
* @abstract: |
||||
* PFR/TrueDoc-specific API. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of PFR-specific functions. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_PFR_Metrics |
||||
* |
||||
* @description: |
||||
* Return the outline and metrics resolutions of a given PFR face. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* Handle to the input face. It can be a non-PFR face. |
||||
* |
||||
* @output: |
||||
* aoutline_resolution :: |
||||
* Outline resolution. This is equivalent to `face->units_per_EM` for |
||||
* non-PFR fonts. Optional (parameter can be `NULL`). |
||||
* |
||||
* ametrics_resolution :: |
||||
* Metrics resolution. This is equivalent to `outline_resolution` for |
||||
* non-PFR fonts. Optional (parameter can be `NULL`). |
||||
* |
||||
* ametrics_x_scale :: |
||||
* A 16.16 fixed-point number used to scale distance expressed in |
||||
* metrics units to device subpixels. This is equivalent to |
||||
* `face->size->x_scale`, but for metrics only. Optional (parameter |
||||
* can be `NULL`). |
||||
* |
||||
* ametrics_y_scale :: |
||||
* Same as `ametrics_x_scale` but for the vertical direction. |
||||
* optional (parameter can be `NULL`). |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If the input face is not a PFR, this function will return an error. |
||||
* However, in all cases, it will return valid values. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_PFR_Metrics( FT_Face face, |
||||
FT_UInt *aoutline_resolution, |
||||
FT_UInt *ametrics_resolution, |
||||
FT_Fixed *ametrics_x_scale, |
||||
FT_Fixed *ametrics_y_scale ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_PFR_Kerning |
||||
* |
||||
* @description: |
||||
* Return the kerning pair corresponding to two glyphs in a PFR face. |
||||
* The distance is expressed in metrics units, unlike the result of |
||||
* @FT_Get_Kerning. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* left :: |
||||
* Index of the left glyph. |
||||
* |
||||
* right :: |
||||
* Index of the right glyph. |
||||
* |
||||
* @output: |
||||
* avector :: |
||||
* A kerning vector. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function always return distances in original PFR metrics units. |
||||
* This is unlike @FT_Get_Kerning with the @FT_KERNING_UNSCALED mode, |
||||
* which always returns distances converted to outline units. |
||||
* |
||||
* You can use the value of the `x_scale` and `y_scale` parameters |
||||
* returned by @FT_Get_PFR_Metrics to scale these to device subpixels. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_PFR_Kerning( FT_Face face, |
||||
FT_UInt left, |
||||
FT_UInt right, |
||||
FT_Vector *avector ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_PFR_Advance |
||||
* |
||||
* @description: |
||||
* Return a given glyph advance, expressed in original metrics units, |
||||
* from a PFR font. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* gindex :: |
||||
* The glyph index. |
||||
* |
||||
* @output: |
||||
* aadvance :: |
||||
* The glyph advance in metrics units. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You can use the `x_scale` or `y_scale` results of @FT_Get_PFR_Metrics |
||||
* to convert the advance to device subpixels (i.e., 1/64 of pixels). |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_PFR_Advance( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Pos *aadvance ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTPFR_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,244 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftrender.h |
||||
* |
||||
* FreeType renderer modules public interface (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTRENDER_H_ |
||||
#define FTRENDER_H_ |
||||
|
||||
|
||||
#include <freetype/ftmodapi.h> |
||||
#include <freetype/ftglyph.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* module_management |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* create a new glyph object */ |
||||
typedef FT_Error |
||||
(*FT_Glyph_InitFunc)( FT_Glyph glyph, |
||||
FT_GlyphSlot slot ); |
||||
|
||||
/* destroys a given glyph object */ |
||||
typedef void |
||||
(*FT_Glyph_DoneFunc)( FT_Glyph glyph ); |
||||
|
||||
typedef void |
||||
(*FT_Glyph_TransformFunc)( FT_Glyph glyph, |
||||
const FT_Matrix* matrix, |
||||
const FT_Vector* delta ); |
||||
|
||||
typedef void |
||||
(*FT_Glyph_GetBBoxFunc)( FT_Glyph glyph, |
||||
FT_BBox* abbox ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Glyph_CopyFunc)( FT_Glyph source, |
||||
FT_Glyph target ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Glyph_PrepareFunc)( FT_Glyph glyph, |
||||
FT_GlyphSlot slot ); |
||||
|
||||
/* deprecated */ |
||||
#define FT_Glyph_Init_Func FT_Glyph_InitFunc |
||||
#define FT_Glyph_Done_Func FT_Glyph_DoneFunc |
||||
#define FT_Glyph_Transform_Func FT_Glyph_TransformFunc |
||||
#define FT_Glyph_BBox_Func FT_Glyph_GetBBoxFunc |
||||
#define FT_Glyph_Copy_Func FT_Glyph_CopyFunc |
||||
#define FT_Glyph_Prepare_Func FT_Glyph_PrepareFunc |
||||
|
||||
|
||||
struct FT_Glyph_Class_ |
||||
{ |
||||
FT_Long glyph_size; |
||||
FT_Glyph_Format glyph_format; |
||||
|
||||
FT_Glyph_InitFunc glyph_init; |
||||
FT_Glyph_DoneFunc glyph_done; |
||||
FT_Glyph_CopyFunc glyph_copy; |
||||
FT_Glyph_TransformFunc glyph_transform; |
||||
FT_Glyph_GetBBoxFunc glyph_bbox; |
||||
FT_Glyph_PrepareFunc glyph_prepare; |
||||
}; |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Renderer_RenderFunc)( FT_Renderer renderer, |
||||
FT_GlyphSlot slot, |
||||
FT_Render_Mode mode, |
||||
const FT_Vector* origin ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Renderer_TransformFunc)( FT_Renderer renderer, |
||||
FT_GlyphSlot slot, |
||||
const FT_Matrix* matrix, |
||||
const FT_Vector* delta ); |
||||
|
||||
|
||||
typedef void |
||||
(*FT_Renderer_GetCBoxFunc)( FT_Renderer renderer, |
||||
FT_GlyphSlot slot, |
||||
FT_BBox* cbox ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Renderer_SetModeFunc)( FT_Renderer renderer, |
||||
FT_ULong mode_tag, |
||||
FT_Pointer mode_ptr ); |
||||
|
||||
/* deprecated identifiers */ |
||||
#define FTRenderer_render FT_Renderer_RenderFunc |
||||
#define FTRenderer_transform FT_Renderer_TransformFunc |
||||
#define FTRenderer_getCBox FT_Renderer_GetCBoxFunc |
||||
#define FTRenderer_setMode FT_Renderer_SetModeFunc |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Renderer_Class |
||||
* |
||||
* @description: |
||||
* The renderer module class descriptor. |
||||
* |
||||
* @fields: |
||||
* root :: |
||||
* The root @FT_Module_Class fields. |
||||
* |
||||
* glyph_format :: |
||||
* The glyph image format this renderer handles. |
||||
* |
||||
* render_glyph :: |
||||
* A method used to render the image that is in a given glyph slot into |
||||
* a bitmap. |
||||
* |
||||
* transform_glyph :: |
||||
* A method used to transform the image that is in a given glyph slot. |
||||
* |
||||
* get_glyph_cbox :: |
||||
* A method used to access the glyph's cbox. |
||||
* |
||||
* set_mode :: |
||||
* A method used to pass additional parameters. |
||||
* |
||||
* raster_class :: |
||||
* For @FT_GLYPH_FORMAT_OUTLINE renderers only. This is a pointer to |
||||
* its raster's class. |
||||
*/ |
||||
typedef struct FT_Renderer_Class_ |
||||
{ |
||||
FT_Module_Class root; |
||||
|
||||
FT_Glyph_Format glyph_format; |
||||
|
||||
FT_Renderer_RenderFunc render_glyph; |
||||
FT_Renderer_TransformFunc transform_glyph; |
||||
FT_Renderer_GetCBoxFunc get_glyph_cbox; |
||||
FT_Renderer_SetModeFunc set_mode; |
||||
|
||||
const FT_Raster_Funcs* raster_class; |
||||
|
||||
} FT_Renderer_Class; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Renderer |
||||
* |
||||
* @description: |
||||
* Retrieve the current renderer for a given glyph format. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A handle to the library object. |
||||
* |
||||
* format :: |
||||
* The glyph format. |
||||
* |
||||
* @return: |
||||
* A renderer handle. 0~if none found. |
||||
* |
||||
* @note: |
||||
* An error will be returned if a module already exists by that name, or |
||||
* if the module requires a version of FreeType that is too great. |
||||
* |
||||
* To add a new renderer, simply use @FT_Add_Module. To retrieve a |
||||
* renderer by its name, use @FT_Get_Module. |
||||
*/ |
||||
FT_EXPORT( FT_Renderer ) |
||||
FT_Get_Renderer( FT_Library library, |
||||
FT_Glyph_Format format ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Set_Renderer |
||||
* |
||||
* @description: |
||||
* Set the current renderer to use, and set additional mode. |
||||
* |
||||
* @inout: |
||||
* library :: |
||||
* A handle to the library object. |
||||
* |
||||
* @input: |
||||
* renderer :: |
||||
* A handle to the renderer object. |
||||
* |
||||
* num_params :: |
||||
* The number of additional parameters. |
||||
* |
||||
* parameters :: |
||||
* Additional parameters. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* In case of success, the renderer will be used to convert glyph images |
||||
* in the renderer's known format into bitmaps. |
||||
* |
||||
* This doesn't change the current renderer for other formats. |
||||
* |
||||
* Currently, no FreeType renderer module uses `parameters`; you should |
||||
* thus always pass `NULL` as the value. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Set_Renderer( FT_Library library, |
||||
FT_Renderer renderer, |
||||
FT_UInt num_params, |
||||
FT_Parameter* parameters ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTRENDER_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,159 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftsizes.h |
||||
* |
||||
* FreeType size objects management (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Typical application would normally not need to use these functions. |
||||
* However, they have been placed in a public API for the rare cases where |
||||
* they are needed. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSIZES_H_ |
||||
#define FTSIZES_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* sizes_management |
||||
* |
||||
* @title: |
||||
* Size Management |
||||
* |
||||
* @abstract: |
||||
* Managing multiple sizes per face. |
||||
* |
||||
* @description: |
||||
* When creating a new face object (e.g., with @FT_New_Face), an @FT_Size |
||||
* object is automatically created and used to store all pixel-size |
||||
* dependent information, available in the `face->size` field. |
||||
* |
||||
* It is however possible to create more sizes for a given face, mostly |
||||
* in order to manage several character pixel sizes of the same font |
||||
* family and style. See @FT_New_Size and @FT_Done_Size. |
||||
* |
||||
* Note that @FT_Set_Pixel_Sizes and @FT_Set_Char_Size only modify the |
||||
* contents of the current 'active' size; you thus need to use |
||||
* @FT_Activate_Size to change it. |
||||
* |
||||
* 99% of applications won't need the functions provided here, especially |
||||
* if they use the caching sub-system, so be cautious when using these. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_New_Size |
||||
* |
||||
* @description: |
||||
* Create a new size object from a given face object. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to a parent face object. |
||||
* |
||||
* @output: |
||||
* asize :: |
||||
* A handle to a new size object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You need to call @FT_Activate_Size in order to select the new size for |
||||
* upcoming calls to @FT_Set_Pixel_Sizes, @FT_Set_Char_Size, |
||||
* @FT_Load_Glyph, @FT_Load_Char, etc. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_New_Size( FT_Face face, |
||||
FT_Size* size ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Done_Size |
||||
* |
||||
* @description: |
||||
* Discard a given size object. Note that @FT_Done_Face automatically |
||||
* discards all size objects allocated with @FT_New_Size. |
||||
* |
||||
* @input: |
||||
* size :: |
||||
* A handle to a target size object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Done_Size( FT_Size size ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Activate_Size |
||||
* |
||||
* @description: |
||||
* Even though it is possible to create several size objects for a given |
||||
* face (see @FT_New_Size for details), functions like @FT_Load_Glyph or |
||||
* @FT_Load_Char only use the one that has been activated last to |
||||
* determine the 'current character pixel size'. |
||||
* |
||||
* This function can be used to 'activate' a previously created size |
||||
* object. |
||||
* |
||||
* @input: |
||||
* size :: |
||||
* A handle to a target size object. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If `face` is the size's parent face object, this function changes the |
||||
* value of `face->size` to the input size handle. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Activate_Size( FT_Size size ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSIZES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,272 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftsnames.h |
||||
* |
||||
* Simple interface to access SFNT 'name' tables (which are used |
||||
* to hold font names, copyright info, notices, etc.) (specification). |
||||
* |
||||
* This is _not_ used to retrieve glyph names! |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSNAMES_H_ |
||||
#define FTSNAMES_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/ftparams.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* sfnt_names |
||||
* |
||||
* @title: |
||||
* SFNT Names |
||||
* |
||||
* @abstract: |
||||
* Access the names embedded in TrueType and OpenType files. |
||||
* |
||||
* @description: |
||||
* The TrueType and OpenType specifications allow the inclusion of a |
||||
* special names table ('name') in font files. This table contains |
||||
* textual (and internationalized) information regarding the font, like |
||||
* family name, copyright, version, etc. |
||||
* |
||||
* The definitions below are used to access them if available. |
||||
* |
||||
* Note that this has nothing to do with glyph names! |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_SfntName |
||||
* |
||||
* @description: |
||||
* A structure used to model an SFNT 'name' table entry. |
||||
* |
||||
* @fields: |
||||
* platform_id :: |
||||
* The platform ID for `string`. See @TT_PLATFORM_XXX for possible |
||||
* values. |
||||
* |
||||
* encoding_id :: |
||||
* The encoding ID for `string`. See @TT_APPLE_ID_XXX, @TT_MAC_ID_XXX, |
||||
* @TT_ISO_ID_XXX, @TT_MS_ID_XXX, and @TT_ADOBE_ID_XXX for possible |
||||
* values. |
||||
* |
||||
* language_id :: |
||||
* The language ID for `string`. See @TT_MAC_LANGID_XXX and |
||||
* @TT_MS_LANGID_XXX for possible values. |
||||
* |
||||
* Registered OpenType values for `language_id` are always smaller than |
||||
* 0x8000; values equal or larger than 0x8000 usually indicate a |
||||
* language tag string (introduced in OpenType version 1.6). Use |
||||
* function @FT_Get_Sfnt_LangTag with `language_id` as its argument to |
||||
* retrieve the associated language tag. |
||||
* |
||||
* name_id :: |
||||
* An identifier for `string`. See @TT_NAME_ID_XXX for possible |
||||
* values. |
||||
* |
||||
* string :: |
||||
* The 'name' string. Note that its format differs depending on the |
||||
* (platform,encoding) pair, being either a string of bytes (without a |
||||
* terminating `NULL` byte) or containing UTF-16BE entities. |
||||
* |
||||
* string_len :: |
||||
* The length of `string` in bytes. |
||||
* |
||||
* @note: |
||||
* Please refer to the TrueType or OpenType specification for more |
||||
* details. |
||||
*/ |
||||
typedef struct FT_SfntName_ |
||||
{ |
||||
FT_UShort platform_id; |
||||
FT_UShort encoding_id; |
||||
FT_UShort language_id; |
||||
FT_UShort name_id; |
||||
|
||||
FT_Byte* string; /* this string is *not* null-terminated! */ |
||||
FT_UInt string_len; /* in bytes */ |
||||
|
||||
} FT_SfntName; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Sfnt_Name_Count |
||||
* |
||||
* @description: |
||||
* Retrieve the number of name strings in the SFNT 'name' table. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* @return: |
||||
* The number of strings in the 'name' table. |
||||
* |
||||
* @note: |
||||
* This function always returns an error if the config macro |
||||
* `TT_CONFIG_OPTION_SFNT_NAMES` is not defined in `ftoption.h`. |
||||
*/ |
||||
FT_EXPORT( FT_UInt ) |
||||
FT_Get_Sfnt_Name_Count( FT_Face face ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Sfnt_Name |
||||
* |
||||
* @description: |
||||
* Retrieve a string of the SFNT 'name' table for a given index. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* idx :: |
||||
* The index of the 'name' string. |
||||
* |
||||
* @output: |
||||
* aname :: |
||||
* The indexed @FT_SfntName structure. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The `string` array returned in the `aname` structure is not |
||||
* null-terminated. Note that you don't have to deallocate `string` by |
||||
* yourself; FreeType takes care of it if you call @FT_Done_Face. |
||||
* |
||||
* Use @FT_Get_Sfnt_Name_Count to get the total number of available |
||||
* 'name' table entries, then do a loop until you get the right platform, |
||||
* encoding, and name ID. |
||||
* |
||||
* 'name' table format~1 entries can use language tags also, see |
||||
* @FT_Get_Sfnt_LangTag. |
||||
* |
||||
* This function always returns an error if the config macro |
||||
* `TT_CONFIG_OPTION_SFNT_NAMES` is not defined in `ftoption.h`. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Sfnt_Name( FT_Face face, |
||||
FT_UInt idx, |
||||
FT_SfntName *aname ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_SfntLangTag |
||||
* |
||||
* @description: |
||||
* A structure to model a language tag entry from an SFNT 'name' table. |
||||
* |
||||
* @fields: |
||||
* string :: |
||||
* The language tag string, encoded in UTF-16BE (without trailing |
||||
* `NULL` bytes). |
||||
* |
||||
* string_len :: |
||||
* The length of `string` in **bytes**. |
||||
* |
||||
* @note: |
||||
* Please refer to the TrueType or OpenType specification for more |
||||
* details. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
*/ |
||||
typedef struct FT_SfntLangTag_ |
||||
{ |
||||
FT_Byte* string; /* this string is *not* null-terminated! */ |
||||
FT_UInt string_len; /* in bytes */ |
||||
|
||||
} FT_SfntLangTag; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_Sfnt_LangTag |
||||
* |
||||
* @description: |
||||
* Retrieve the language tag associated with a language ID of an SFNT |
||||
* 'name' table entry. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the source face. |
||||
* |
||||
* langID :: |
||||
* The language ID, as returned by @FT_Get_Sfnt_Name. This is always a |
||||
* value larger than 0x8000. |
||||
* |
||||
* @output: |
||||
* alangTag :: |
||||
* The language tag associated with the 'name' table entry's language |
||||
* ID. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The `string` array returned in the `alangTag` structure is not |
||||
* null-terminated. Note that you don't have to deallocate `string` by |
||||
* yourself; FreeType takes care of it if you call @FT_Done_Face. |
||||
* |
||||
* Only 'name' table format~1 supports language tags. For format~0 |
||||
* tables, this function always returns FT_Err_Invalid_Table. For |
||||
* invalid format~1 language ID values, FT_Err_Invalid_Argument is |
||||
* returned. |
||||
* |
||||
* This function always returns an error if the config macro |
||||
* `TT_CONFIG_OPTION_SFNT_NAMES` is not defined in `ftoption.h`. |
||||
* |
||||
* @since: |
||||
* 2.8 |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_Sfnt_LangTag( FT_Face face, |
||||
FT_UInt langID, |
||||
FT_SfntLangTag *alangTag ); |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSNAMES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,773 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftstroke.h |
||||
* |
||||
* FreeType path stroker (specification). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSTROKE_H_ |
||||
#define FTSTROKE_H_ |
||||
|
||||
#include <freetype/ftoutln.h> |
||||
#include <freetype/ftglyph.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* glyph_stroker |
||||
* |
||||
* @title: |
||||
* Glyph Stroker |
||||
* |
||||
* @abstract: |
||||
* Generating bordered and stroked glyphs. |
||||
* |
||||
* @description: |
||||
* This component generates stroked outlines of a given vectorial glyph. |
||||
* It also allows you to retrieve the 'outside' and/or the 'inside' |
||||
* borders of the stroke. |
||||
* |
||||
* This can be useful to generate 'bordered' glyph, i.e., glyphs |
||||
* displayed with a colored (and anti-aliased) border around their |
||||
* shape. |
||||
* |
||||
* @order: |
||||
* FT_Stroker |
||||
* |
||||
* FT_Stroker_LineJoin |
||||
* FT_Stroker_LineCap |
||||
* FT_StrokerBorder |
||||
* |
||||
* FT_Outline_GetInsideBorder |
||||
* FT_Outline_GetOutsideBorder |
||||
* |
||||
* FT_Glyph_Stroke |
||||
* FT_Glyph_StrokeBorder |
||||
* |
||||
* FT_Stroker_New |
||||
* FT_Stroker_Set |
||||
* FT_Stroker_Rewind |
||||
* FT_Stroker_ParseOutline |
||||
* FT_Stroker_Done |
||||
* |
||||
* FT_Stroker_BeginSubPath |
||||
* FT_Stroker_EndSubPath |
||||
* |
||||
* FT_Stroker_LineTo |
||||
* FT_Stroker_ConicTo |
||||
* FT_Stroker_CubicTo |
||||
* |
||||
* FT_Stroker_GetBorderCounts |
||||
* FT_Stroker_ExportBorder |
||||
* FT_Stroker_GetCounts |
||||
* FT_Stroker_Export |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Stroker |
||||
* |
||||
* @description: |
||||
* Opaque handle to a path stroker object. |
||||
*/ |
||||
typedef struct FT_StrokerRec_* FT_Stroker; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_Stroker_LineJoin |
||||
* |
||||
* @description: |
||||
* These values determine how two joining lines are rendered in a |
||||
* stroker. |
||||
* |
||||
* @values: |
||||
* FT_STROKER_LINEJOIN_ROUND :: |
||||
* Used to render rounded line joins. Circular arcs are used to join |
||||
* two lines smoothly. |
||||
* |
||||
* FT_STROKER_LINEJOIN_BEVEL :: |
||||
* Used to render beveled line joins. The outer corner of the joined |
||||
* lines is filled by enclosing the triangular region of the corner |
||||
* with a straight line between the outer corners of each stroke. |
||||
* |
||||
* FT_STROKER_LINEJOIN_MITER_FIXED :: |
||||
* Used to render mitered line joins, with fixed bevels if the miter |
||||
* limit is exceeded. The outer edges of the strokes for the two |
||||
* segments are extended until they meet at an angle. A bevel join |
||||
* (see above) is used if the segments meet at too sharp an angle and |
||||
* the outer edges meet beyond a distance corresponding to the meter |
||||
* limit. This prevents long spikes being created. |
||||
* `FT_STROKER_LINEJOIN_MITER_FIXED` generates a miter line join as |
||||
* used in PostScript and PDF. |
||||
* |
||||
* FT_STROKER_LINEJOIN_MITER_VARIABLE :: |
||||
* FT_STROKER_LINEJOIN_MITER :: |
||||
* Used to render mitered line joins, with variable bevels if the miter |
||||
* limit is exceeded. The intersection of the strokes is clipped |
||||
* perpendicularly to the bisector, at a distance corresponding to |
||||
* the miter limit. This prevents long spikes being created. |
||||
* `FT_STROKER_LINEJOIN_MITER_VARIABLE` generates a mitered line join |
||||
* as used in XPS. `FT_STROKER_LINEJOIN_MITER` is an alias for |
||||
* `FT_STROKER_LINEJOIN_MITER_VARIABLE`, retained for backward |
||||
* compatibility. |
||||
*/ |
||||
typedef enum FT_Stroker_LineJoin_ |
||||
{ |
||||
FT_STROKER_LINEJOIN_ROUND = 0, |
||||
FT_STROKER_LINEJOIN_BEVEL = 1, |
||||
FT_STROKER_LINEJOIN_MITER_VARIABLE = 2, |
||||
FT_STROKER_LINEJOIN_MITER = FT_STROKER_LINEJOIN_MITER_VARIABLE, |
||||
FT_STROKER_LINEJOIN_MITER_FIXED = 3 |
||||
|
||||
} FT_Stroker_LineJoin; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_Stroker_LineCap |
||||
* |
||||
* @description: |
||||
* These values determine how the end of opened sub-paths are rendered in |
||||
* a stroke. |
||||
* |
||||
* @values: |
||||
* FT_STROKER_LINECAP_BUTT :: |
||||
* The end of lines is rendered as a full stop on the last point |
||||
* itself. |
||||
* |
||||
* FT_STROKER_LINECAP_ROUND :: |
||||
* The end of lines is rendered as a half-circle around the last point. |
||||
* |
||||
* FT_STROKER_LINECAP_SQUARE :: |
||||
* The end of lines is rendered as a square around the last point. |
||||
*/ |
||||
typedef enum FT_Stroker_LineCap_ |
||||
{ |
||||
FT_STROKER_LINECAP_BUTT = 0, |
||||
FT_STROKER_LINECAP_ROUND, |
||||
FT_STROKER_LINECAP_SQUARE |
||||
|
||||
} FT_Stroker_LineCap; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_StrokerBorder |
||||
* |
||||
* @description: |
||||
* These values are used to select a given stroke border in |
||||
* @FT_Stroker_GetBorderCounts and @FT_Stroker_ExportBorder. |
||||
* |
||||
* @values: |
||||
* FT_STROKER_BORDER_LEFT :: |
||||
* Select the left border, relative to the drawing direction. |
||||
* |
||||
* FT_STROKER_BORDER_RIGHT :: |
||||
* Select the right border, relative to the drawing direction. |
||||
* |
||||
* @note: |
||||
* Applications are generally interested in the 'inside' and 'outside' |
||||
* borders. However, there is no direct mapping between these and the |
||||
* 'left' and 'right' ones, since this really depends on the glyph's |
||||
* drawing orientation, which varies between font formats. |
||||
* |
||||
* You can however use @FT_Outline_GetInsideBorder and |
||||
* @FT_Outline_GetOutsideBorder to get these. |
||||
*/ |
||||
typedef enum FT_StrokerBorder_ |
||||
{ |
||||
FT_STROKER_BORDER_LEFT = 0, |
||||
FT_STROKER_BORDER_RIGHT |
||||
|
||||
} FT_StrokerBorder; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_GetInsideBorder |
||||
* |
||||
* @description: |
||||
* Retrieve the @FT_StrokerBorder value corresponding to the 'inside' |
||||
* borders of a given outline. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* The source outline handle. |
||||
* |
||||
* @return: |
||||
* The border index. @FT_STROKER_BORDER_RIGHT for empty or invalid |
||||
* outlines. |
||||
*/ |
||||
FT_EXPORT( FT_StrokerBorder ) |
||||
FT_Outline_GetInsideBorder( FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Outline_GetOutsideBorder |
||||
* |
||||
* @description: |
||||
* Retrieve the @FT_StrokerBorder value corresponding to the 'outside' |
||||
* borders of a given outline. |
||||
* |
||||
* @input: |
||||
* outline :: |
||||
* The source outline handle. |
||||
* |
||||
* @return: |
||||
* The border index. @FT_STROKER_BORDER_LEFT for empty or invalid |
||||
* outlines. |
||||
*/ |
||||
FT_EXPORT( FT_StrokerBorder ) |
||||
FT_Outline_GetOutsideBorder( FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_New |
||||
* |
||||
* @description: |
||||
* Create a new stroker object. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* FreeType library handle. |
||||
* |
||||
* @output: |
||||
* astroker :: |
||||
* A new stroker object handle. `NULL` in case of error. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_New( FT_Library library, |
||||
FT_Stroker *astroker ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_Set |
||||
* |
||||
* @description: |
||||
* Reset a stroker object's attributes. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* radius :: |
||||
* The border radius. |
||||
* |
||||
* line_cap :: |
||||
* The line cap style. |
||||
* |
||||
* line_join :: |
||||
* The line join style. |
||||
* |
||||
* miter_limit :: |
||||
* The maximum reciprocal sine of half-angle at the miter join, |
||||
* expressed as 16.16 fixed-point value. |
||||
* |
||||
* @note: |
||||
* The `radius` is expressed in the same units as the outline |
||||
* coordinates. |
||||
* |
||||
* The `miter_limit` multiplied by the `radius` gives the maximum size |
||||
* of a miter spike, at which it is clipped for |
||||
* @FT_STROKER_LINEJOIN_MITER_VARIABLE or replaced with a bevel join for |
||||
* @FT_STROKER_LINEJOIN_MITER_FIXED. |
||||
* |
||||
* This function calls @FT_Stroker_Rewind automatically. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Stroker_Set( FT_Stroker stroker, |
||||
FT_Fixed radius, |
||||
FT_Stroker_LineCap line_cap, |
||||
FT_Stroker_LineJoin line_join, |
||||
FT_Fixed miter_limit ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_Rewind |
||||
* |
||||
* @description: |
||||
* Reset a stroker object without changing its attributes. You should |
||||
* call this function before beginning a new series of calls to |
||||
* @FT_Stroker_BeginSubPath or @FT_Stroker_EndSubPath. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Stroker_Rewind( FT_Stroker stroker ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_ParseOutline |
||||
* |
||||
* @description: |
||||
* A convenience function used to parse a whole outline with the stroker. |
||||
* The resulting outline(s) can be retrieved later by functions like |
||||
* @FT_Stroker_GetCounts and @FT_Stroker_Export. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* outline :: |
||||
* The source outline. |
||||
* |
||||
* opened :: |
||||
* A boolean. If~1, the outline is treated as an open path instead of |
||||
* a closed one. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* If `opened` is~0 (the default), the outline is treated as a closed |
||||
* path, and the stroker generates two distinct 'border' outlines. |
||||
* |
||||
* If `opened` is~1, the outline is processed as an open path, and the |
||||
* stroker generates a single 'stroke' outline. |
||||
* |
||||
* This function calls @FT_Stroker_Rewind automatically. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_ParseOutline( FT_Stroker stroker, |
||||
FT_Outline* outline, |
||||
FT_Bool opened ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_BeginSubPath |
||||
* |
||||
* @description: |
||||
* Start a new sub-path in the stroker. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* to :: |
||||
* A pointer to the start vector. |
||||
* |
||||
* open :: |
||||
* A boolean. If~1, the sub-path is treated as an open one. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function is useful when you need to stroke a path that is not |
||||
* stored as an @FT_Outline object. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_BeginSubPath( FT_Stroker stroker, |
||||
FT_Vector* to, |
||||
FT_Bool open ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_EndSubPath |
||||
* |
||||
* @description: |
||||
* Close the current sub-path in the stroker. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You should call this function after @FT_Stroker_BeginSubPath. If the |
||||
* subpath was not 'opened', this function 'draws' a single line segment |
||||
* to the start position when needed. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_EndSubPath( FT_Stroker stroker ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_LineTo |
||||
* |
||||
* @description: |
||||
* 'Draw' a single line segment in the stroker's current sub-path, from |
||||
* the last position. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* to :: |
||||
* A pointer to the destination point. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You should call this function between @FT_Stroker_BeginSubPath and |
||||
* @FT_Stroker_EndSubPath. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_LineTo( FT_Stroker stroker, |
||||
FT_Vector* to ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_ConicTo |
||||
* |
||||
* @description: |
||||
* 'Draw' a single quadratic Bezier in the stroker's current sub-path, |
||||
* from the last position. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* control :: |
||||
* A pointer to a Bezier control point. |
||||
* |
||||
* to :: |
||||
* A pointer to the destination point. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You should call this function between @FT_Stroker_BeginSubPath and |
||||
* @FT_Stroker_EndSubPath. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_ConicTo( FT_Stroker stroker, |
||||
FT_Vector* control, |
||||
FT_Vector* to ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_CubicTo |
||||
* |
||||
* @description: |
||||
* 'Draw' a single cubic Bezier in the stroker's current sub-path, from |
||||
* the last position. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* control1 :: |
||||
* A pointer to the first Bezier control point. |
||||
* |
||||
* control2 :: |
||||
* A pointer to second Bezier control point. |
||||
* |
||||
* to :: |
||||
* A pointer to the destination point. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* You should call this function between @FT_Stroker_BeginSubPath and |
||||
* @FT_Stroker_EndSubPath. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_CubicTo( FT_Stroker stroker, |
||||
FT_Vector* control1, |
||||
FT_Vector* control2, |
||||
FT_Vector* to ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_GetBorderCounts |
||||
* |
||||
* @description: |
||||
* Call this function once you have finished parsing your paths with the |
||||
* stroker. It returns the number of points and contours necessary to |
||||
* export one of the 'border' or 'stroke' outlines generated by the |
||||
* stroker. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* border :: |
||||
* The border index. |
||||
* |
||||
* @output: |
||||
* anum_points :: |
||||
* The number of points. |
||||
* |
||||
* anum_contours :: |
||||
* The number of contours. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* When an outline, or a sub-path, is 'closed', the stroker generates two |
||||
* independent 'border' outlines, named 'left' and 'right'. |
||||
* |
||||
* When the outline, or a sub-path, is 'opened', the stroker merges the |
||||
* 'border' outlines with caps. The 'left' border receives all points, |
||||
* while the 'right' border becomes empty. |
||||
* |
||||
* Use the function @FT_Stroker_GetCounts instead if you want to retrieve |
||||
* the counts associated to both borders. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_GetBorderCounts( FT_Stroker stroker, |
||||
FT_StrokerBorder border, |
||||
FT_UInt *anum_points, |
||||
FT_UInt *anum_contours ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_ExportBorder |
||||
* |
||||
* @description: |
||||
* Call this function after @FT_Stroker_GetBorderCounts to export the |
||||
* corresponding border to your own @FT_Outline structure. |
||||
* |
||||
* Note that this function appends the border points and contours to your |
||||
* outline, but does not try to resize its arrays. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* border :: |
||||
* The border index. |
||||
* |
||||
* outline :: |
||||
* The target outline handle. |
||||
* |
||||
* @note: |
||||
* Always call this function after @FT_Stroker_GetBorderCounts to get |
||||
* sure that there is enough room in your @FT_Outline object to receive |
||||
* all new data. |
||||
* |
||||
* When an outline, or a sub-path, is 'closed', the stroker generates two |
||||
* independent 'border' outlines, named 'left' and 'right'. |
||||
* |
||||
* When the outline, or a sub-path, is 'opened', the stroker merges the |
||||
* 'border' outlines with caps. The 'left' border receives all points, |
||||
* while the 'right' border becomes empty. |
||||
* |
||||
* Use the function @FT_Stroker_Export instead if you want to retrieve |
||||
* all borders at once. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Stroker_ExportBorder( FT_Stroker stroker, |
||||
FT_StrokerBorder border, |
||||
FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_GetCounts |
||||
* |
||||
* @description: |
||||
* Call this function once you have finished parsing your paths with the |
||||
* stroker. It returns the number of points and contours necessary to |
||||
* export all points/borders from the stroked outline/path. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* @output: |
||||
* anum_points :: |
||||
* The number of points. |
||||
* |
||||
* anum_contours :: |
||||
* The number of contours. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Stroker_GetCounts( FT_Stroker stroker, |
||||
FT_UInt *anum_points, |
||||
FT_UInt *anum_contours ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_Export |
||||
* |
||||
* @description: |
||||
* Call this function after @FT_Stroker_GetBorderCounts to export all |
||||
* borders to your own @FT_Outline structure. |
||||
* |
||||
* Note that this function appends the border points and contours to your |
||||
* outline, but does not try to resize its arrays. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* The target stroker handle. |
||||
* |
||||
* outline :: |
||||
* The target outline handle. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Stroker_Export( FT_Stroker stroker, |
||||
FT_Outline* outline ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Stroker_Done |
||||
* |
||||
* @description: |
||||
* Destroy a stroker object. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* A stroker handle. Can be `NULL`. |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Stroker_Done( FT_Stroker stroker ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_Stroke |
||||
* |
||||
* @description: |
||||
* Stroke a given outline glyph object with a given stroker. |
||||
* |
||||
* @inout: |
||||
* pglyph :: |
||||
* Source glyph handle on input, new glyph handle on output. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* A stroker handle. |
||||
* |
||||
* destroy :: |
||||
* A Boolean. If~1, the source glyph object is destroyed on success. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The source glyph is untouched in case of error. |
||||
* |
||||
* Adding stroke may yield a significantly wider and taller glyph |
||||
* depending on how large of a radius was used to stroke the glyph. You |
||||
* may need to manually adjust horizontal and vertical advance amounts to |
||||
* account for this added size. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Glyph_Stroke( FT_Glyph *pglyph, |
||||
FT_Stroker stroker, |
||||
FT_Bool destroy ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Glyph_StrokeBorder |
||||
* |
||||
* @description: |
||||
* Stroke a given outline glyph object with a given stroker, but only |
||||
* return either its inside or outside border. |
||||
* |
||||
* @inout: |
||||
* pglyph :: |
||||
* Source glyph handle on input, new glyph handle on output. |
||||
* |
||||
* @input: |
||||
* stroker :: |
||||
* A stroker handle. |
||||
* |
||||
* inside :: |
||||
* A Boolean. If~1, return the inside border, otherwise the outside |
||||
* border. |
||||
* |
||||
* destroy :: |
||||
* A Boolean. If~1, the source glyph object is destroyed on success. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* The source glyph is untouched in case of error. |
||||
* |
||||
* Adding stroke may yield a significantly wider and taller glyph |
||||
* depending on how large of a radius was used to stroke the glyph. You |
||||
* may need to manually adjust horizontal and vertical advance amounts to |
||||
* account for this added size. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Glyph_StrokeBorder( FT_Glyph *pglyph, |
||||
FT_Stroker stroker, |
||||
FT_Bool inside, |
||||
FT_Bool destroy ); |
||||
|
||||
/* */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSTROKE_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
|
||||
|
||||
/* Local Variables: */ |
||||
/* coding: utf-8 */ |
||||
/* End: */ |
||||
@ -0,0 +1,104 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftsynth.h |
||||
* |
||||
* FreeType synthesizing code for emboldening and slanting |
||||
* (specification). |
||||
* |
||||
* Copyright (C) 2000-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/********* *********/ |
||||
/********* WARNING, THIS IS ALPHA CODE! THIS API *********/ |
||||
/********* IS DUE TO CHANGE UNTIL STRICTLY NOTIFIED BY THE *********/ |
||||
/********* FREETYPE DEVELOPMENT TEAM *********/ |
||||
/********* *********/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
|
||||
/* Main reason for not lifting the functions in this module to a */ |
||||
/* 'standard' API is that the used parameters for emboldening and */ |
||||
/* slanting are not configurable. Consider the functions as a */ |
||||
/* code resource that should be copied into the application and */ |
||||
/* adapted to the particular needs. */ |
||||
|
||||
|
||||
#ifndef FTSYNTH_H_ |
||||
#define FTSYNTH_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/* Embolden a glyph by a 'reasonable' value (which is highly a matter of */ |
||||
/* taste). This function is actually a convenience function, providing */ |
||||
/* a wrapper for @FT_Outline_Embolden and @FT_Bitmap_Embolden. */ |
||||
/* */ |
||||
/* For emboldened outlines the height, width, and advance metrics are */ |
||||
/* increased by the strength of the emboldening -- this even affects */ |
||||
/* mono-width fonts! */ |
||||
/* */ |
||||
/* You can also call @FT_Outline_Get_CBox to get precise values. */ |
||||
FT_EXPORT( void ) |
||||
FT_GlyphSlot_Embolden( FT_GlyphSlot slot ); |
||||
|
||||
/* Precisely adjust the glyph weight either horizontally or vertically. */ |
||||
/* The `xdelta` and `ydelta` values are fractions of the face Em size */ |
||||
/* (in fixed-point format). Considering that a regular face would have */ |
||||
/* stem widths on the order of 0.1 Em, a delta of 0.05 (0x0CCC) should */ |
||||
/* be very noticeable. To increase or decrease the weight, use positive */ |
||||
/* or negative values, respectively. */ |
||||
FT_EXPORT( void ) |
||||
FT_GlyphSlot_AdjustWeight( FT_GlyphSlot slot, |
||||
FT_Fixed xdelta, |
||||
FT_Fixed ydelta ); |
||||
|
||||
|
||||
/* Slant an outline glyph to the right by about 12 degrees. */ |
||||
FT_EXPORT( void ) |
||||
FT_GlyphSlot_Oblique( FT_GlyphSlot slot ); |
||||
|
||||
/* Slant an outline glyph by a given sine of an angle. You can apply */ |
||||
/* slant along either x- or y-axis by choosing a corresponding non-zero */ |
||||
/* argument. If both slants are non-zero, some affine transformation */ |
||||
/* will result. */ |
||||
FT_EXPORT( void ) |
||||
FT_GlyphSlot_Slant( FT_GlyphSlot slot, |
||||
FT_Fixed xslant, |
||||
FT_Fixed yslant ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSYNTH_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,350 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftsystem.h |
||||
* |
||||
* FreeType low-level system interface definition (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSYSTEM_H_ |
||||
#define FTSYSTEM_H_ |
||||
|
||||
|
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* system_interface |
||||
* |
||||
* @title: |
||||
* System Interface |
||||
* |
||||
* @abstract: |
||||
* How FreeType manages memory and i/o. |
||||
* |
||||
* @description: |
||||
* This section contains various definitions related to memory management |
||||
* and i/o access. You need to understand this information if you want to |
||||
* use a custom memory manager or you own i/o streams. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* M E M O R Y M A N A G E M E N T |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Memory |
||||
* |
||||
* @description: |
||||
* A handle to a given memory manager object, defined with an |
||||
* @FT_MemoryRec structure. |
||||
* |
||||
*/ |
||||
typedef struct FT_MemoryRec_* FT_Memory; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Alloc_Func |
||||
* |
||||
* @description: |
||||
* A function used to allocate `size` bytes from `memory`. |
||||
* |
||||
* @input: |
||||
* memory :: |
||||
* A handle to the source memory manager. |
||||
* |
||||
* size :: |
||||
* The size in bytes to allocate. |
||||
* |
||||
* @return: |
||||
* Address of new memory block. 0~in case of failure. |
||||
* |
||||
*/ |
||||
typedef void* |
||||
(*FT_Alloc_Func)( FT_Memory memory, |
||||
long size ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Free_Func |
||||
* |
||||
* @description: |
||||
* A function used to release a given block of memory. |
||||
* |
||||
* @input: |
||||
* memory :: |
||||
* A handle to the source memory manager. |
||||
* |
||||
* block :: |
||||
* The address of the target memory block. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*FT_Free_Func)( FT_Memory memory, |
||||
void* block ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Realloc_Func |
||||
* |
||||
* @description: |
||||
* A function used to re-allocate a given block of memory. |
||||
* |
||||
* @input: |
||||
* memory :: |
||||
* A handle to the source memory manager. |
||||
* |
||||
* cur_size :: |
||||
* The block's current size in bytes. |
||||
* |
||||
* new_size :: |
||||
* The block's requested new size. |
||||
* |
||||
* block :: |
||||
* The block's current address. |
||||
* |
||||
* @return: |
||||
* New block address. 0~in case of memory shortage. |
||||
* |
||||
* @note: |
||||
* In case of error, the old block must still be available. |
||||
* |
||||
*/ |
||||
typedef void* |
||||
(*FT_Realloc_Func)( FT_Memory memory, |
||||
long cur_size, |
||||
long new_size, |
||||
void* block ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_MemoryRec |
||||
* |
||||
* @description: |
||||
* A structure used to describe a given memory manager to FreeType~2. |
||||
* |
||||
* @fields: |
||||
* user :: |
||||
* A generic typeless pointer for user data. |
||||
* |
||||
* alloc :: |
||||
* A pointer type to an allocation function. |
||||
* |
||||
* free :: |
||||
* A pointer type to an memory freeing function. |
||||
* |
||||
* realloc :: |
||||
* A pointer type to a reallocation function. |
||||
* |
||||
*/ |
||||
struct FT_MemoryRec_ |
||||
{ |
||||
void* user; |
||||
FT_Alloc_Func alloc; |
||||
FT_Free_Func free; |
||||
FT_Realloc_Func realloc; |
||||
}; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* I / O M A N A G E M E N T |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Stream |
||||
* |
||||
* @description: |
||||
* A handle to an input stream. |
||||
* |
||||
* @also: |
||||
* See @FT_StreamRec for the publicly accessible fields of a given stream |
||||
* object. |
||||
* |
||||
*/ |
||||
typedef struct FT_StreamRec_* FT_Stream; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_StreamDesc |
||||
* |
||||
* @description: |
||||
* A union type used to store either a long or a pointer. This is used |
||||
* to store a file descriptor or a `FILE*` in an input stream. |
||||
* |
||||
*/ |
||||
typedef union FT_StreamDesc_ |
||||
{ |
||||
long value; |
||||
void* pointer; |
||||
|
||||
} FT_StreamDesc; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Stream_IoFunc |
||||
* |
||||
* @description: |
||||
* A function used to seek and read data from a given input stream. |
||||
* |
||||
* @input: |
||||
* stream :: |
||||
* A handle to the source stream. |
||||
* |
||||
* offset :: |
||||
* The offset from the start of the stream to seek to. |
||||
* |
||||
* buffer :: |
||||
* The address of the read buffer. |
||||
* |
||||
* count :: |
||||
* The number of bytes to read from the stream. |
||||
* |
||||
* @return: |
||||
* If count >~0, return the number of bytes effectively read by the |
||||
* stream (after seeking to `offset`). If count ==~0, return the status |
||||
* of the seek operation (non-zero indicates an error). |
||||
* |
||||
*/ |
||||
typedef unsigned long |
||||
(*FT_Stream_IoFunc)( FT_Stream stream, |
||||
unsigned long offset, |
||||
unsigned char* buffer, |
||||
unsigned long count ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Stream_CloseFunc |
||||
* |
||||
* @description: |
||||
* A function used to close a given input stream. |
||||
* |
||||
* @input: |
||||
* stream :: |
||||
* A handle to the target stream. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*FT_Stream_CloseFunc)( FT_Stream stream ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_StreamRec |
||||
* |
||||
* @description: |
||||
* A structure used to describe an input stream. |
||||
* |
||||
* @input: |
||||
* base :: |
||||
* For memory-based streams, this is the address of the first stream |
||||
* byte in memory. This field should always be set to `NULL` for |
||||
* disk-based streams. |
||||
* |
||||
* size :: |
||||
* The stream size in bytes. |
||||
* |
||||
* In case of compressed streams where the size is unknown before |
||||
* actually doing the decompression, the value is set to 0x7FFFFFFF. |
||||
* (Note that this size value can occur for normal streams also; it is |
||||
* thus just a hint.) |
||||
* |
||||
* pos :: |
||||
* The current position within the stream. |
||||
* |
||||
* descriptor :: |
||||
* This field is a union that can hold an integer or a pointer. It is |
||||
* used by stream implementations to store file descriptors or `FILE*` |
||||
* pointers. |
||||
* |
||||
* pathname :: |
||||
* This field is completely ignored by FreeType. However, it is often |
||||
* useful during debugging to use it to store the stream's filename |
||||
* (where available). |
||||
* |
||||
* read :: |
||||
* The stream's input function. |
||||
* |
||||
* close :: |
||||
* The stream's close function. |
||||
* |
||||
* memory :: |
||||
* The memory manager to use to preload frames. This is set internally |
||||
* by FreeType and shouldn't be touched by stream implementations. |
||||
* |
||||
* cursor :: |
||||
* This field is set and used internally by FreeType when parsing |
||||
* frames. In particular, the `FT_GET_XXX` macros use this instead of |
||||
* the `pos` field. |
||||
* |
||||
* limit :: |
||||
* This field is set and used internally by FreeType when parsing |
||||
* frames. |
||||
* |
||||
*/ |
||||
typedef struct FT_StreamRec_ |
||||
{ |
||||
unsigned char* base; |
||||
unsigned long size; |
||||
unsigned long pos; |
||||
|
||||
FT_StreamDesc descriptor; |
||||
FT_StreamDesc pathname; |
||||
FT_Stream_IoFunc read; |
||||
FT_Stream_CloseFunc close; |
||||
|
||||
FT_Memory memory; |
||||
unsigned char* cursor; |
||||
unsigned char* limit; |
||||
|
||||
} FT_StreamRec; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSYSTEM_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,350 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fttrigon.h |
||||
* |
||||
* FreeType trigonometric functions (specification). |
||||
* |
||||
* Copyright (C) 2001-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTTRIGON_H_ |
||||
#define FTTRIGON_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* computations |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Angle |
||||
* |
||||
* @description: |
||||
* This type is used to model angle values in FreeType. Note that the |
||||
* angle is a 16.16 fixed-point value expressed in degrees. |
||||
* |
||||
*/ |
||||
typedef FT_Fixed FT_Angle; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ANGLE_PI |
||||
* |
||||
* @description: |
||||
* The angle pi expressed in @FT_Angle units. |
||||
* |
||||
*/ |
||||
#define FT_ANGLE_PI ( 180L << 16 ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ANGLE_2PI |
||||
* |
||||
* @description: |
||||
* The angle 2*pi expressed in @FT_Angle units. |
||||
* |
||||
*/ |
||||
#define FT_ANGLE_2PI ( FT_ANGLE_PI * 2 ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ANGLE_PI2 |
||||
* |
||||
* @description: |
||||
* The angle pi/2 expressed in @FT_Angle units. |
||||
* |
||||
*/ |
||||
#define FT_ANGLE_PI2 ( FT_ANGLE_PI / 2 ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_ANGLE_PI4 |
||||
* |
||||
* @description: |
||||
* The angle pi/4 expressed in @FT_Angle units. |
||||
* |
||||
*/ |
||||
#define FT_ANGLE_PI4 ( FT_ANGLE_PI / 4 ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Sin |
||||
* |
||||
* @description: |
||||
* Return the sinus of a given angle in fixed-point format. |
||||
* |
||||
* @input: |
||||
* angle :: |
||||
* The input angle. |
||||
* |
||||
* @return: |
||||
* The sinus value. |
||||
* |
||||
* @note: |
||||
* If you need both the sinus and cosinus for a given angle, use the |
||||
* function @FT_Vector_Unit. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Fixed ) |
||||
FT_Sin( FT_Angle angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Cos |
||||
* |
||||
* @description: |
||||
* Return the cosinus of a given angle in fixed-point format. |
||||
* |
||||
* @input: |
||||
* angle :: |
||||
* The input angle. |
||||
* |
||||
* @return: |
||||
* The cosinus value. |
||||
* |
||||
* @note: |
||||
* If you need both the sinus and cosinus for a given angle, use the |
||||
* function @FT_Vector_Unit. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Fixed ) |
||||
FT_Cos( FT_Angle angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Tan |
||||
* |
||||
* @description: |
||||
* Return the tangent of a given angle in fixed-point format. |
||||
* |
||||
* @input: |
||||
* angle :: |
||||
* The input angle. |
||||
* |
||||
* @return: |
||||
* The tangent value. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Fixed ) |
||||
FT_Tan( FT_Angle angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Atan2 |
||||
* |
||||
* @description: |
||||
* Return the arc-tangent corresponding to a given vector (x,y) in the 2d |
||||
* plane. |
||||
* |
||||
* @input: |
||||
* x :: |
||||
* The horizontal vector coordinate. |
||||
* |
||||
* y :: |
||||
* The vertical vector coordinate. |
||||
* |
||||
* @return: |
||||
* The arc-tangent value (i.e. angle). |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Angle ) |
||||
FT_Atan2( FT_Fixed x, |
||||
FT_Fixed y ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Angle_Diff |
||||
* |
||||
* @description: |
||||
* Return the difference between two angles. The result is always |
||||
* constrained to the ]-PI..PI] interval. |
||||
* |
||||
* @input: |
||||
* angle1 :: |
||||
* First angle. |
||||
* |
||||
* angle2 :: |
||||
* Second angle. |
||||
* |
||||
* @return: |
||||
* Constrained value of `angle2-angle1`. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Angle ) |
||||
FT_Angle_Diff( FT_Angle angle1, |
||||
FT_Angle angle2 ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Vector_Unit |
||||
* |
||||
* @description: |
||||
* Return the unit vector corresponding to a given angle. After the |
||||
* call, the value of `vec.x` will be `cos(angle)`, and the value of |
||||
* `vec.y` will be `sin(angle)`. |
||||
* |
||||
* This function is useful to retrieve both the sinus and cosinus of a |
||||
* given angle quickly. |
||||
* |
||||
* @output: |
||||
* vec :: |
||||
* The address of target vector. |
||||
* |
||||
* @input: |
||||
* angle :: |
||||
* The input angle. |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Vector_Unit( FT_Vector* vec, |
||||
FT_Angle angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Vector_Rotate |
||||
* |
||||
* @description: |
||||
* Rotate a vector by a given angle. |
||||
* |
||||
* @inout: |
||||
* vec :: |
||||
* The address of target vector. |
||||
* |
||||
* @input: |
||||
* angle :: |
||||
* The input angle. |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Vector_Rotate( FT_Vector* vec, |
||||
FT_Angle angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Vector_Length |
||||
* |
||||
* @description: |
||||
* Return the length of a given vector. |
||||
* |
||||
* @input: |
||||
* vec :: |
||||
* The address of target vector. |
||||
* |
||||
* @return: |
||||
* The vector length, expressed in the same units that the original |
||||
* vector coordinates. |
||||
* |
||||
*/ |
||||
FT_EXPORT( FT_Fixed ) |
||||
FT_Vector_Length( FT_Vector* vec ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Vector_Polarize |
||||
* |
||||
* @description: |
||||
* Compute both the length and angle of a given vector. |
||||
* |
||||
* @input: |
||||
* vec :: |
||||
* The address of source vector. |
||||
* |
||||
* @output: |
||||
* length :: |
||||
* The vector length. |
||||
* |
||||
* angle :: |
||||
* The vector angle. |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Vector_Polarize( FT_Vector* vec, |
||||
FT_Fixed *length, |
||||
FT_Angle *angle ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Vector_From_Polar |
||||
* |
||||
* @description: |
||||
* Compute vector coordinates from a length and angle. |
||||
* |
||||
* @output: |
||||
* vec :: |
||||
* The address of source vector. |
||||
* |
||||
* @input: |
||||
* length :: |
||||
* The vector length. |
||||
* |
||||
* angle :: |
||||
* The vector angle. |
||||
* |
||||
*/ |
||||
FT_EXPORT( void ) |
||||
FT_Vector_From_Polar( FT_Vector* vec, |
||||
FT_Fixed length, |
||||
FT_Angle angle ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTTRIGON_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,617 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fttypes.h |
||||
* |
||||
* FreeType simple types definitions (specification only). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTTYPES_H_ |
||||
#define FTTYPES_H_ |
||||
|
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_CONFIG_H |
||||
#include <freetype/ftsystem.h> |
||||
#include <freetype/ftimage.h> |
||||
|
||||
#include <stddef.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* basic_types |
||||
* |
||||
* @title: |
||||
* Basic Data Types |
||||
* |
||||
* @abstract: |
||||
* The basic data types defined by the library. |
||||
* |
||||
* @description: |
||||
* This section contains the basic data types defined by FreeType~2, |
||||
* ranging from simple scalar types to bitmap descriptors. More |
||||
* font-specific structures are defined in a different section. Note |
||||
* that FreeType does not use floating-point data types. Fractional |
||||
* values are represented by fixed-point integers, with lower bits |
||||
* storing the fractional part. |
||||
* |
||||
* @order: |
||||
* FT_Byte |
||||
* FT_Bytes |
||||
* FT_Char |
||||
* FT_Int |
||||
* FT_UInt |
||||
* FT_Int16 |
||||
* FT_UInt16 |
||||
* FT_Int32 |
||||
* FT_UInt32 |
||||
* FT_Int64 |
||||
* FT_UInt64 |
||||
* FT_Short |
||||
* FT_UShort |
||||
* FT_Long |
||||
* FT_ULong |
||||
* FT_Bool |
||||
* FT_Offset |
||||
* FT_PtrDist |
||||
* FT_String |
||||
* FT_Tag |
||||
* FT_Error |
||||
* FT_Fixed |
||||
* FT_Pointer |
||||
* FT_Pos |
||||
* FT_Vector |
||||
* FT_BBox |
||||
* FT_Matrix |
||||
* FT_FWord |
||||
* FT_UFWord |
||||
* FT_F2Dot14 |
||||
* FT_UnitVector |
||||
* FT_F26Dot6 |
||||
* FT_Data |
||||
* |
||||
* FT_MAKE_TAG |
||||
* |
||||
* FT_Generic |
||||
* FT_Generic_Finalizer |
||||
* |
||||
* FT_Bitmap |
||||
* FT_Pixel_Mode |
||||
* FT_Palette_Mode |
||||
* FT_Glyph_Format |
||||
* FT_IMAGE_TAG |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Bool |
||||
* |
||||
* @description: |
||||
* A typedef of unsigned char, used for simple booleans. As usual, |
||||
* values 1 and~0 represent true and false, respectively. |
||||
*/ |
||||
typedef unsigned char FT_Bool; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_FWord |
||||
* |
||||
* @description: |
||||
* A signed 16-bit integer used to store a distance in original font |
||||
* units. |
||||
*/ |
||||
typedef signed short FT_FWord; /* distance in FUnits */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UFWord |
||||
* |
||||
* @description: |
||||
* An unsigned 16-bit integer used to store a distance in original font |
||||
* units. |
||||
*/ |
||||
typedef unsigned short FT_UFWord; /* unsigned distance */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Char |
||||
* |
||||
* @description: |
||||
* A simple typedef for the _signed_ char type. |
||||
*/ |
||||
typedef signed char FT_Char; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Byte |
||||
* |
||||
* @description: |
||||
* A simple typedef for the _unsigned_ char type. |
||||
*/ |
||||
typedef unsigned char FT_Byte; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Bytes |
||||
* |
||||
* @description: |
||||
* A typedef for constant memory areas. |
||||
*/ |
||||
typedef const FT_Byte* FT_Bytes; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Tag |
||||
* |
||||
* @description: |
||||
* A typedef for 32-bit tags (as used in the SFNT format). |
||||
*/ |
||||
typedef FT_UInt32 FT_Tag; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_String |
||||
* |
||||
* @description: |
||||
* A simple typedef for the char type, usually used for strings. |
||||
*/ |
||||
typedef char FT_String; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Short |
||||
* |
||||
* @description: |
||||
* A typedef for signed short. |
||||
*/ |
||||
typedef signed short FT_Short; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UShort |
||||
* |
||||
* @description: |
||||
* A typedef for unsigned short. |
||||
*/ |
||||
typedef unsigned short FT_UShort; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int |
||||
* |
||||
* @description: |
||||
* A typedef for the int type. |
||||
*/ |
||||
typedef signed int FT_Int; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt |
||||
* |
||||
* @description: |
||||
* A typedef for the unsigned int type. |
||||
*/ |
||||
typedef unsigned int FT_UInt; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Long |
||||
* |
||||
* @description: |
||||
* A typedef for signed long. |
||||
*/ |
||||
typedef signed long FT_Long; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_ULong |
||||
* |
||||
* @description: |
||||
* A typedef for unsigned long. |
||||
*/ |
||||
typedef unsigned long FT_ULong; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_F2Dot14 |
||||
* |
||||
* @description: |
||||
* A signed 2.14 fixed-point type used for unit vectors. |
||||
*/ |
||||
typedef signed short FT_F2Dot14; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_F26Dot6 |
||||
* |
||||
* @description: |
||||
* A signed 26.6 fixed-point type used for vectorial pixel coordinates. |
||||
*/ |
||||
typedef signed long FT_F26Dot6; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Fixed |
||||
* |
||||
* @description: |
||||
* This type is used to store 16.16 fixed-point values, like scaling |
||||
* values or matrix coefficients. |
||||
*/ |
||||
typedef signed long FT_Fixed; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Error |
||||
* |
||||
* @description: |
||||
* The FreeType error code type. A value of~0 is always interpreted as a |
||||
* successful operation. |
||||
*/ |
||||
typedef int FT_Error; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Pointer |
||||
* |
||||
* @description: |
||||
* A simple typedef for a typeless pointer. |
||||
*/ |
||||
typedef void* FT_Pointer; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Offset |
||||
* |
||||
* @description: |
||||
* This is equivalent to the ANSI~C `size_t` type, i.e., the largest |
||||
* _unsigned_ integer type used to express a file size or position, or a |
||||
* memory block size. |
||||
*/ |
||||
typedef size_t FT_Offset; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_PtrDist |
||||
* |
||||
* @description: |
||||
* This is equivalent to the ANSI~C `ptrdiff_t` type, i.e., the largest |
||||
* _signed_ integer type used to express the distance between two |
||||
* pointers. |
||||
*/ |
||||
typedef ft_ptrdiff_t FT_PtrDist; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_UnitVector |
||||
* |
||||
* @description: |
||||
* A simple structure used to store a 2D vector unit vector. Uses |
||||
* FT_F2Dot14 types. |
||||
* |
||||
* @fields: |
||||
* x :: |
||||
* Horizontal coordinate. |
||||
* |
||||
* y :: |
||||
* Vertical coordinate. |
||||
*/ |
||||
typedef struct FT_UnitVector_ |
||||
{ |
||||
FT_F2Dot14 x; |
||||
FT_F2Dot14 y; |
||||
|
||||
} FT_UnitVector; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Matrix |
||||
* |
||||
* @description: |
||||
* A simple structure used to store a 2x2 matrix. Coefficients are in |
||||
* 16.16 fixed-point format. The computation performed is: |
||||
* |
||||
* ``` |
||||
* x' = x*xx + y*xy |
||||
* y' = x*yx + y*yy |
||||
* ``` |
||||
* |
||||
* @fields: |
||||
* xx :: |
||||
* Matrix coefficient. |
||||
* |
||||
* xy :: |
||||
* Matrix coefficient. |
||||
* |
||||
* yx :: |
||||
* Matrix coefficient. |
||||
* |
||||
* yy :: |
||||
* Matrix coefficient. |
||||
*/ |
||||
typedef struct FT_Matrix_ |
||||
{ |
||||
FT_Fixed xx, xy; |
||||
FT_Fixed yx, yy; |
||||
|
||||
} FT_Matrix; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Data |
||||
* |
||||
* @description: |
||||
* Read-only binary data represented as a pointer and a length. |
||||
* |
||||
* @fields: |
||||
* pointer :: |
||||
* The data. |
||||
* |
||||
* length :: |
||||
* The length of the data in bytes. |
||||
*/ |
||||
typedef struct FT_Data_ |
||||
{ |
||||
const FT_Byte* pointer; |
||||
FT_UInt length; |
||||
|
||||
} FT_Data; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_Generic_Finalizer |
||||
* |
||||
* @description: |
||||
* Describe a function used to destroy the 'client' data of any FreeType |
||||
* object. See the description of the @FT_Generic type for details of |
||||
* usage. |
||||
* |
||||
* @input: |
||||
* The address of the FreeType object that is under finalization. Its |
||||
* client data is accessed through its `generic` field. |
||||
*/ |
||||
typedef void (*FT_Generic_Finalizer)( void* object ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Generic |
||||
* |
||||
* @description: |
||||
* Client applications often need to associate their own data to a |
||||
* variety of FreeType core objects. For example, a text layout API |
||||
* might want to associate a glyph cache to a given size object. |
||||
* |
||||
* Some FreeType object contains a `generic` field, of type `FT_Generic`, |
||||
* which usage is left to client applications and font servers. |
||||
* |
||||
* It can be used to store a pointer to client-specific data, as well as |
||||
* the address of a 'finalizer' function, which will be called by |
||||
* FreeType when the object is destroyed (for example, the previous |
||||
* client example would put the address of the glyph cache destructor in |
||||
* the `finalizer` field). |
||||
* |
||||
* @fields: |
||||
* data :: |
||||
* A typeless pointer to any client-specified data. This field is |
||||
* completely ignored by the FreeType library. |
||||
* |
||||
* finalizer :: |
||||
* A pointer to a 'generic finalizer' function, which will be called |
||||
* when the object is destroyed. If this field is set to `NULL`, no |
||||
* code will be called. |
||||
*/ |
||||
typedef struct FT_Generic_ |
||||
{ |
||||
void* data; |
||||
FT_Generic_Finalizer finalizer; |
||||
|
||||
} FT_Generic; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_MAKE_TAG |
||||
* |
||||
* @description: |
||||
* This macro converts four-letter tags that are used to label TrueType |
||||
* tables into an `FT_Tag` type, to be used within FreeType. |
||||
* |
||||
* @note: |
||||
* The produced values **must** be 32-bit integers. Don't redefine this |
||||
* macro. |
||||
*/ |
||||
#define FT_MAKE_TAG( _x1, _x2, _x3, _x4 ) \ |
||||
( ( FT_STATIC_BYTE_CAST( FT_Tag, _x1 ) << 24 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_Tag, _x2 ) << 16 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_Tag, _x3 ) << 8 ) | \
|
||||
FT_STATIC_BYTE_CAST( FT_Tag, _x4 ) ) |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/* */ |
||||
/* L I S T M A N A G E M E N T */ |
||||
/* */ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* list_processing |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_ListNode |
||||
* |
||||
* @description: |
||||
* Many elements and objects in FreeType are listed through an @FT_List |
||||
* record (see @FT_ListRec). As its name suggests, an FT_ListNode is a |
||||
* handle to a single list element. |
||||
*/ |
||||
typedef struct FT_ListNodeRec_* FT_ListNode; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_List |
||||
* |
||||
* @description: |
||||
* A handle to a list record (see @FT_ListRec). |
||||
*/ |
||||
typedef struct FT_ListRec_* FT_List; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_ListNodeRec |
||||
* |
||||
* @description: |
||||
* A structure used to hold a single list element. |
||||
* |
||||
* @fields: |
||||
* prev :: |
||||
* The previous element in the list. `NULL` if first. |
||||
* |
||||
* next :: |
||||
* The next element in the list. `NULL` if last. |
||||
* |
||||
* data :: |
||||
* A typeless pointer to the listed object. |
||||
*/ |
||||
typedef struct FT_ListNodeRec_ |
||||
{ |
||||
FT_ListNode prev; |
||||
FT_ListNode next; |
||||
void* data; |
||||
|
||||
} FT_ListNodeRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_ListRec |
||||
* |
||||
* @description: |
||||
* A structure used to hold a simple doubly-linked list. These are used |
||||
* in many parts of FreeType. |
||||
* |
||||
* @fields: |
||||
* head :: |
||||
* The head (first element) of doubly-linked list. |
||||
* |
||||
* tail :: |
||||
* The tail (last element) of doubly-linked list. |
||||
*/ |
||||
typedef struct FT_ListRec_ |
||||
{ |
||||
FT_ListNode head; |
||||
FT_ListNode tail; |
||||
|
||||
} FT_ListRec; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
#define FT_IS_EMPTY( list ) ( (list).head == 0 ) |
||||
#define FT_BOOL( x ) FT_STATIC_CAST( FT_Bool, (x) != 0 ) |
||||
|
||||
/* concatenate C tokens */ |
||||
#define FT_ERR_XCAT( x, y ) x ## y |
||||
#define FT_ERR_CAT( x, y ) FT_ERR_XCAT( x, y ) |
||||
|
||||
/* see `ftmoderr.h` for descriptions of the following macros */ |
||||
|
||||
#define FT_ERR( e ) FT_ERR_CAT( FT_ERR_PREFIX, e ) |
||||
|
||||
#define FT_ERROR_BASE( x ) ( (x) & 0xFF ) |
||||
#define FT_ERROR_MODULE( x ) ( (x) & 0xFF00U ) |
||||
|
||||
#define FT_ERR_EQ( x, e ) \ |
||||
( FT_ERROR_BASE( x ) == FT_ERROR_BASE( FT_ERR( e ) ) ) |
||||
#define FT_ERR_NEQ( x, e ) \ |
||||
( FT_ERROR_BASE( x ) != FT_ERROR_BASE( FT_ERR( e ) ) ) |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTTYPES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,276 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftwinfnt.h |
||||
* |
||||
* FreeType API for accessing Windows fnt-specific data. |
||||
* |
||||
* Copyright (C) 2003-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTWINFNT_H_ |
||||
#define FTWINFNT_H_ |
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#ifdef FREETYPE_H |
||||
#error "freetype.h of FreeType 1 has been loaded!" |
||||
#error "Please fix the directory search order for header files" |
||||
#error "so that freetype.h of FreeType 2 is found first." |
||||
#endif |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* winfnt_fonts |
||||
* |
||||
* @title: |
||||
* Window FNT Files |
||||
* |
||||
* @abstract: |
||||
* Windows FNT-specific API. |
||||
* |
||||
* @description: |
||||
* This section contains the declaration of Windows FNT-specific |
||||
* functions. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @enum: |
||||
* FT_WinFNT_ID_XXX |
||||
* |
||||
* @description: |
||||
* A list of valid values for the `charset` byte in @FT_WinFNT_HeaderRec. |
||||
* Exact mapping tables for the various 'cpXXXX' encodings (except for |
||||
* 'cp1361') can be found at 'ftp://ftp.unicode.org/Public/' in the
|
||||
* `MAPPINGS/VENDORS/MICSFT/WINDOWS` subdirectory. 'cp1361' is roughly a |
||||
* superset of `MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT`. |
||||
* |
||||
* @values: |
||||
* FT_WinFNT_ID_DEFAULT :: |
||||
* This is used for font enumeration and font creation as a 'don't |
||||
* care' value. Valid font files don't contain this value. When |
||||
* querying for information about the character set of the font that is |
||||
* currently selected into a specified device context, this return |
||||
* value (of the related Windows API) simply denotes failure. |
||||
* |
||||
* FT_WinFNT_ID_SYMBOL :: |
||||
* There is no known mapping table available. |
||||
* |
||||
* FT_WinFNT_ID_MAC :: |
||||
* Mac Roman encoding. |
||||
* |
||||
* FT_WinFNT_ID_OEM :: |
||||
* From Michael Poettgen <michael@poettgen.de>: |
||||
* |
||||
* The 'Windows Font Mapping' article says that `FT_WinFNT_ID_OEM` is |
||||
* used for the charset of vector fonts, like `modern.fon`, |
||||
* `roman.fon`, and `script.fon` on Windows. |
||||
* |
||||
* The 'CreateFont' documentation says: The `FT_WinFNT_ID_OEM` value |
||||
* specifies a character set that is operating-system dependent. |
||||
* |
||||
* The 'IFIMETRICS' documentation from the 'Windows Driver Development |
||||
* Kit' says: This font supports an OEM-specific character set. The |
||||
* OEM character set is system dependent. |
||||
* |
||||
* In general OEM, as opposed to ANSI (i.e., 'cp1252'), denotes the |
||||
* second default codepage that most international versions of Windows |
||||
* have. It is one of the OEM codepages from |
||||
* |
||||
* https://docs.microsoft.com/en-us/windows/desktop/intl/code-page-identifiers
|
||||
* , |
||||
* |
||||
* and is used for the 'DOS boxes', to support legacy applications. A |
||||
* German Windows version for example usually uses ANSI codepage 1252 |
||||
* and OEM codepage 850. |
||||
* |
||||
* FT_WinFNT_ID_CP874 :: |
||||
* A superset of Thai TIS 620 and ISO 8859-11. |
||||
* |
||||
* FT_WinFNT_ID_CP932 :: |
||||
* A superset of Japanese Shift-JIS (with minor deviations). |
||||
* |
||||
* FT_WinFNT_ID_CP936 :: |
||||
* A superset of simplified Chinese GB 2312-1980 (with different |
||||
* ordering and minor deviations). |
||||
* |
||||
* FT_WinFNT_ID_CP949 :: |
||||
* A superset of Korean Hangul KS~C 5601-1987 (with different ordering |
||||
* and minor deviations). |
||||
* |
||||
* FT_WinFNT_ID_CP950 :: |
||||
* A superset of traditional Chinese Big~5 ETen (with different |
||||
* ordering and minor deviations). |
||||
* |
||||
* FT_WinFNT_ID_CP1250 :: |
||||
* A superset of East European ISO 8859-2 (with slightly different |
||||
* ordering). |
||||
* |
||||
* FT_WinFNT_ID_CP1251 :: |
||||
* A superset of Russian ISO 8859-5 (with different ordering). |
||||
* |
||||
* FT_WinFNT_ID_CP1252 :: |
||||
* ANSI encoding. A superset of ISO 8859-1. |
||||
* |
||||
* FT_WinFNT_ID_CP1253 :: |
||||
* A superset of Greek ISO 8859-7 (with minor modifications). |
||||
* |
||||
* FT_WinFNT_ID_CP1254 :: |
||||
* A superset of Turkish ISO 8859-9. |
||||
* |
||||
* FT_WinFNT_ID_CP1255 :: |
||||
* A superset of Hebrew ISO 8859-8 (with some modifications). |
||||
* |
||||
* FT_WinFNT_ID_CP1256 :: |
||||
* A superset of Arabic ISO 8859-6 (with different ordering). |
||||
* |
||||
* FT_WinFNT_ID_CP1257 :: |
||||
* A superset of Baltic ISO 8859-13 (with some deviations). |
||||
* |
||||
* FT_WinFNT_ID_CP1258 :: |
||||
* For Vietnamese. This encoding doesn't cover all necessary |
||||
* characters. |
||||
* |
||||
* FT_WinFNT_ID_CP1361 :: |
||||
* Korean (Johab). |
||||
*/ |
||||
|
||||
#define FT_WinFNT_ID_CP1252 0 |
||||
#define FT_WinFNT_ID_DEFAULT 1 |
||||
#define FT_WinFNT_ID_SYMBOL 2 |
||||
#define FT_WinFNT_ID_MAC 77 |
||||
#define FT_WinFNT_ID_CP932 128 |
||||
#define FT_WinFNT_ID_CP949 129 |
||||
#define FT_WinFNT_ID_CP1361 130 |
||||
#define FT_WinFNT_ID_CP936 134 |
||||
#define FT_WinFNT_ID_CP950 136 |
||||
#define FT_WinFNT_ID_CP1253 161 |
||||
#define FT_WinFNT_ID_CP1254 162 |
||||
#define FT_WinFNT_ID_CP1258 163 |
||||
#define FT_WinFNT_ID_CP1255 177 |
||||
#define FT_WinFNT_ID_CP1256 178 |
||||
#define FT_WinFNT_ID_CP1257 186 |
||||
#define FT_WinFNT_ID_CP1251 204 |
||||
#define FT_WinFNT_ID_CP874 222 |
||||
#define FT_WinFNT_ID_CP1250 238 |
||||
#define FT_WinFNT_ID_OEM 255 |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_WinFNT_HeaderRec |
||||
* |
||||
* @description: |
||||
* Windows FNT Header info. |
||||
*/ |
||||
typedef struct FT_WinFNT_HeaderRec_ |
||||
{ |
||||
FT_UShort version; |
||||
FT_ULong file_size; |
||||
FT_Byte copyright[60]; |
||||
FT_UShort file_type; |
||||
FT_UShort nominal_point_size; |
||||
FT_UShort vertical_resolution; |
||||
FT_UShort horizontal_resolution; |
||||
FT_UShort ascent; |
||||
FT_UShort internal_leading; |
||||
FT_UShort external_leading; |
||||
FT_Byte italic; |
||||
FT_Byte underline; |
||||
FT_Byte strike_out; |
||||
FT_UShort weight; |
||||
FT_Byte charset; |
||||
FT_UShort pixel_width; |
||||
FT_UShort pixel_height; |
||||
FT_Byte pitch_and_family; |
||||
FT_UShort avg_width; |
||||
FT_UShort max_width; |
||||
FT_Byte first_char; |
||||
FT_Byte last_char; |
||||
FT_Byte default_char; |
||||
FT_Byte break_char; |
||||
FT_UShort bytes_per_row; |
||||
FT_ULong device_offset; |
||||
FT_ULong face_name_offset; |
||||
FT_ULong bits_pointer; |
||||
FT_ULong bits_offset; |
||||
FT_Byte reserved; |
||||
FT_ULong flags; |
||||
FT_UShort A_space; |
||||
FT_UShort B_space; |
||||
FT_UShort C_space; |
||||
FT_UShort color_table_offset; |
||||
FT_ULong reserved1[4]; |
||||
|
||||
} FT_WinFNT_HeaderRec; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_WinFNT_Header |
||||
* |
||||
* @description: |
||||
* A handle to an @FT_WinFNT_HeaderRec structure. |
||||
*/ |
||||
typedef struct FT_WinFNT_HeaderRec_* FT_WinFNT_Header; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Get_WinFNT_Header |
||||
* |
||||
* @description: |
||||
* Retrieve a Windows FNT font info header. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the input face. |
||||
* |
||||
* @output: |
||||
* aheader :: |
||||
* The WinFNT header. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0~means success. |
||||
* |
||||
* @note: |
||||
* This function only works with Windows FNT faces, returning an error |
||||
* otherwise. |
||||
*/ |
||||
FT_EXPORT( FT_Error ) |
||||
FT_Get_WinFNT_Header( FT_Face face, |
||||
FT_WinFNT_HeaderRec *aheader ); |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTWINFNT_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
|
||||
|
||||
/* Local Variables: */ |
||||
/* coding: utf-8 */ |
||||
/* End: */ |
||||
@ -0,0 +1,234 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* autohint.h |
||||
* |
||||
* High-level 'autohint' module-specific interface (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* The auto-hinter is used to load and automatically hint glyphs if a |
||||
* format-specific hinter isn't available. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef AUTOHINT_H_ |
||||
#define AUTOHINT_H_ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* A small technical note regarding automatic hinting in order to clarify |
||||
* this module interface. |
||||
* |
||||
* An automatic hinter might compute two kinds of data for a given face: |
||||
* |
||||
* - global hints: Usually some metrics that describe global properties |
||||
* of the face. It is computed by scanning more or less |
||||
* aggressively the glyphs in the face, and thus can be |
||||
* very slow to compute (even if the size of global hints |
||||
* is really small). |
||||
* |
||||
* - glyph hints: These describe some important features of the glyph |
||||
* outline, as well as how to align them. They are |
||||
* generally much faster to compute than global hints. |
||||
* |
||||
* The current FreeType auto-hinter does a pretty good job while performing |
||||
* fast computations for both global and glyph hints. However, we might be |
||||
* interested in introducing more complex and powerful algorithms in the |
||||
* future, like the one described in the John D. Hobby paper, which |
||||
* unfortunately requires a lot more horsepower. |
||||
* |
||||
* Because a sufficiently sophisticated font management system would |
||||
* typically implement an LRU cache of opened face objects to reduce memory |
||||
* usage, it is a good idea to be able to avoid recomputing global hints |
||||
* every time the same face is re-opened. |
||||
* |
||||
* We thus provide the ability to cache global hints outside of the face |
||||
* object, in order to speed up font re-opening time. Of course, this |
||||
* feature is purely optional, so most client programs won't even notice |
||||
* it. |
||||
* |
||||
* I initially thought that it would be a good idea to cache the glyph |
||||
* hints too. However, my general idea now is that if you really need to |
||||
* cache these too, you are simply in need of a new font format, where all |
||||
* this information could be stored within the font file and decoded on the |
||||
* fly. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
typedef struct FT_AutoHinterRec_ *FT_AutoHinter; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_AutoHinter_GlobalGetFunc |
||||
* |
||||
* @description: |
||||
* Retrieve the global hints computed for a given face object. The |
||||
* resulting data is dissociated from the face and will survive a call to |
||||
* FT_Done_Face(). It must be discarded through the API |
||||
* FT_AutoHinter_GlobalDoneFunc(). |
||||
* |
||||
* @input: |
||||
* hinter :: |
||||
* A handle to the source auto-hinter. |
||||
* |
||||
* face :: |
||||
* A handle to the source face object. |
||||
* |
||||
* @output: |
||||
* global_hints :: |
||||
* A typeless pointer to the global hints. |
||||
* |
||||
* global_len :: |
||||
* The size in bytes of the global hints. |
||||
*/ |
||||
typedef void |
||||
(*FT_AutoHinter_GlobalGetFunc)( FT_AutoHinter hinter, |
||||
FT_Face face, |
||||
void** global_hints, |
||||
long* global_len ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_AutoHinter_GlobalDoneFunc |
||||
* |
||||
* @description: |
||||
* Discard the global hints retrieved through |
||||
* FT_AutoHinter_GlobalGetFunc(). This is the only way these hints are |
||||
* freed from memory. |
||||
* |
||||
* @input: |
||||
* hinter :: |
||||
* A handle to the auto-hinter module. |
||||
* |
||||
* global :: |
||||
* A pointer to retrieved global hints to discard. |
||||
*/ |
||||
typedef void |
||||
(*FT_AutoHinter_GlobalDoneFunc)( FT_AutoHinter hinter, |
||||
void* global ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_AutoHinter_GlobalResetFunc |
||||
* |
||||
* @description: |
||||
* This function is used to recompute the global metrics in a given font. |
||||
* This is useful when global font data changes (e.g. Multiple Masters |
||||
* fonts where blend coordinates change). |
||||
* |
||||
* @input: |
||||
* hinter :: |
||||
* A handle to the source auto-hinter. |
||||
* |
||||
* face :: |
||||
* A handle to the face. |
||||
*/ |
||||
typedef void |
||||
(*FT_AutoHinter_GlobalResetFunc)( FT_AutoHinter hinter, |
||||
FT_Face face ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* FT_AutoHinter_GlyphLoadFunc |
||||
* |
||||
* @description: |
||||
* This function is used to load, scale, and automatically hint a glyph |
||||
* from a given face. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* A handle to the face. |
||||
* |
||||
* glyph_index :: |
||||
* The glyph index. |
||||
* |
||||
* load_flags :: |
||||
* The load flags. |
||||
* |
||||
* @note: |
||||
* This function is capable of loading composite glyphs by hinting each |
||||
* sub-glyph independently (which improves quality). |
||||
* |
||||
* It will call the font driver with @FT_Load_Glyph, with |
||||
* @FT_LOAD_NO_SCALE set. |
||||
*/ |
||||
typedef FT_Error |
||||
(*FT_AutoHinter_GlyphLoadFunc)( FT_AutoHinter hinter, |
||||
FT_GlyphSlot slot, |
||||
FT_Size size, |
||||
FT_UInt glyph_index, |
||||
FT_Int32 load_flags ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_AutoHinter_InterfaceRec |
||||
* |
||||
* @description: |
||||
* The auto-hinter module's interface. |
||||
*/ |
||||
typedef struct FT_AutoHinter_InterfaceRec_ |
||||
{ |
||||
FT_AutoHinter_GlobalResetFunc reset_face; |
||||
FT_AutoHinter_GlobalGetFunc get_global_hints; |
||||
FT_AutoHinter_GlobalDoneFunc done_global_hints; |
||||
FT_AutoHinter_GlyphLoadFunc load_glyph; |
||||
|
||||
} FT_AutoHinter_InterfaceRec, *FT_AutoHinter_Interface; |
||||
|
||||
|
||||
#define FT_DECLARE_AUTOHINTER_INTERFACE( class_ ) \ |
||||
FT_CALLBACK_TABLE const FT_AutoHinter_InterfaceRec class_; |
||||
|
||||
#define FT_DEFINE_AUTOHINTER_INTERFACE( \ |
||||
class_, \
|
||||
reset_face_, \
|
||||
get_global_hints_, \
|
||||
done_global_hints_, \
|
||||
load_glyph_ ) \
|
||||
FT_CALLBACK_TABLE_DEF \
|
||||
const FT_AutoHinter_InterfaceRec class_ = \
|
||||
{ \
|
||||
reset_face_, \
|
||||
get_global_hints_, \
|
||||
done_global_hints_, \
|
||||
load_glyph_ \
|
||||
}; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* AUTOHINT_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,107 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* cffotypes.h |
||||
* |
||||
* Basic OpenType/CFF object type definitions (specification). |
||||
* |
||||
* Copyright (C) 2017-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef CFFOTYPES_H_ |
||||
#define CFFOTYPES_H_ |
||||
|
||||
#include <freetype/internal/ftobjs.h> |
||||
#include <freetype/internal/cfftypes.h> |
||||
#include <freetype/internal/tttypes.h> |
||||
#include <freetype/internal/services/svpscmap.h> |
||||
#include <freetype/internal/pshints.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
typedef TT_Face CFF_Face; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* CFF_Size |
||||
* |
||||
* @description: |
||||
* A handle to an OpenType size object. |
||||
*/ |
||||
typedef struct CFF_SizeRec_ |
||||
{ |
||||
FT_SizeRec root; |
||||
FT_ULong strike_index; /* 0xFFFFFFFF to indicate invalid */ |
||||
|
||||
} CFF_SizeRec, *CFF_Size; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* CFF_GlyphSlot |
||||
* |
||||
* @description: |
||||
* A handle to an OpenType glyph slot object. |
||||
*/ |
||||
typedef struct CFF_GlyphSlotRec_ |
||||
{ |
||||
FT_GlyphSlotRec root; |
||||
|
||||
FT_Bool hint; |
||||
FT_Bool scaled; |
||||
|
||||
FT_Fixed x_scale; |
||||
FT_Fixed y_scale; |
||||
|
||||
} CFF_GlyphSlotRec, *CFF_GlyphSlot; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* CFF_Internal |
||||
* |
||||
* @description: |
||||
* The interface to the 'internal' field of `FT_Size`. |
||||
*/ |
||||
typedef struct CFF_InternalRec_ |
||||
{ |
||||
PSH_Globals topfont; |
||||
PSH_Globals subfonts[CFF_MAX_CID_FONTS]; |
||||
|
||||
} CFF_InternalRec, *CFF_Internal; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Subglyph transformation record. |
||||
*/ |
||||
typedef struct CFF_Transform_ |
||||
{ |
||||
FT_Fixed xx, xy; /* transformation matrix coefficients */ |
||||
FT_Fixed yx, yy; |
||||
FT_F26Dot6 ox, oy; /* offsets */ |
||||
|
||||
} CFF_Transform; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* CFFOTYPES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,416 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* cfftypes.h |
||||
* |
||||
* Basic OpenType/CFF type definitions and interface (specification |
||||
* only). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef CFFTYPES_H_ |
||||
#define CFFTYPES_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/t1tables.h> |
||||
#include <freetype/internal/ftserv.h> |
||||
#include <freetype/internal/services/svpscmap.h> |
||||
#include <freetype/internal/pshints.h> |
||||
#include <freetype/internal/t1types.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* CFF_IndexRec |
||||
* |
||||
* @description: |
||||
* A structure used to model a CFF Index table. |
||||
* |
||||
* @fields: |
||||
* stream :: |
||||
* The source input stream. |
||||
* |
||||
* start :: |
||||
* The position of the first index byte in the input stream. |
||||
* |
||||
* count :: |
||||
* The number of elements in the index. |
||||
* |
||||
* off_size :: |
||||
* The size in bytes of object offsets in index. |
||||
* |
||||
* data_offset :: |
||||
* The position of first data byte in the index's bytes. |
||||
* |
||||
* data_size :: |
||||
* The size of the data table in this index. |
||||
* |
||||
* offsets :: |
||||
* A table of element offsets in the index. Must be loaded explicitly. |
||||
* |
||||
* bytes :: |
||||
* If the index is loaded in memory, its bytes. |
||||
*/ |
||||
typedef struct CFF_IndexRec_ |
||||
{ |
||||
FT_Stream stream; |
||||
FT_ULong start; |
||||
FT_UInt hdr_size; |
||||
FT_UInt count; |
||||
FT_Byte off_size; |
||||
FT_ULong data_offset; |
||||
FT_ULong data_size; |
||||
|
||||
FT_ULong* offsets; |
||||
FT_Byte* bytes; |
||||
|
||||
} CFF_IndexRec, *CFF_Index; |
||||
|
||||
|
||||
typedef struct CFF_EncodingRec_ |
||||
{ |
||||
FT_UInt format; |
||||
FT_ULong offset; |
||||
|
||||
FT_UInt count; |
||||
FT_UShort sids [256]; /* avoid dynamic allocations */ |
||||
FT_UShort codes[256]; |
||||
|
||||
} CFF_EncodingRec, *CFF_Encoding; |
||||
|
||||
|
||||
typedef struct CFF_CharsetRec_ |
||||
{ |
||||
|
||||
FT_UInt format; |
||||
FT_ULong offset; |
||||
|
||||
FT_UShort* sids; |
||||
FT_UShort* cids; /* the inverse mapping of `sids'; only needed */ |
||||
/* for CID-keyed fonts */ |
||||
FT_UInt max_cid; |
||||
FT_UInt num_glyphs; |
||||
|
||||
} CFF_CharsetRec, *CFF_Charset; |
||||
|
||||
|
||||
/* cf. similar fields in file `ttgxvar.h' from the `truetype' module */ |
||||
|
||||
typedef struct CFF_VarData_ |
||||
{ |
||||
#if 0 |
||||
FT_UInt itemCount; /* not used; always zero */ |
||||
FT_UInt shortDeltaCount; /* not used; always zero */ |
||||
#endif |
||||
|
||||
FT_UInt regionIdxCount; /* number of region indexes */ |
||||
FT_UInt* regionIndices; /* array of `regionIdxCount' indices; */ |
||||
/* these index `varRegionList' */ |
||||
} CFF_VarData; |
||||
|
||||
|
||||
/* contribution of one axis to a region */ |
||||
typedef struct CFF_AxisCoords_ |
||||
{ |
||||
FT_Fixed startCoord; |
||||
FT_Fixed peakCoord; /* zero peak means no effect (factor = 1) */ |
||||
FT_Fixed endCoord; |
||||
|
||||
} CFF_AxisCoords; |
||||
|
||||
|
||||
typedef struct CFF_VarRegion_ |
||||
{ |
||||
CFF_AxisCoords* axisList; /* array of axisCount records */ |
||||
|
||||
} CFF_VarRegion; |
||||
|
||||
|
||||
typedef struct CFF_VStoreRec_ |
||||
{ |
||||
FT_UInt dataCount; |
||||
CFF_VarData* varData; /* array of dataCount records */ |
||||
/* vsindex indexes this array */ |
||||
FT_UShort axisCount; |
||||
FT_UInt regionCount; /* total number of regions defined */ |
||||
CFF_VarRegion* varRegionList; |
||||
|
||||
} CFF_VStoreRec, *CFF_VStore; |
||||
|
||||
|
||||
/* forward reference */ |
||||
typedef struct CFF_FontRec_* CFF_Font; |
||||
|
||||
|
||||
/* This object manages one cached blend vector. */ |
||||
/* */ |
||||
/* There is a BlendRec for Private DICT parsing in each subfont */ |
||||
/* and a BlendRec for charstrings in CF2_Font instance data. */ |
||||
/* A cached BV may be used across DICTs or Charstrings if inputs */ |
||||
/* have not changed. */ |
||||
/* */ |
||||
/* `usedBV' is reset at the start of each parse or charstring. */ |
||||
/* vsindex cannot be changed after a BV is used. */ |
||||
/* */ |
||||
/* Note: NDV is long (32/64 bit), while BV is 16.16 (FT_Int32). */ |
||||
typedef struct CFF_BlendRec_ |
||||
{ |
||||
FT_Bool builtBV; /* blendV has been built */ |
||||
FT_Bool usedBV; /* blendV has been used */ |
||||
CFF_Font font; /* top level font struct */ |
||||
FT_UInt lastVsindex; /* last vsindex used */ |
||||
FT_UInt lenNDV; /* normDV length (aka numAxes) */ |
||||
FT_Fixed* lastNDV; /* last NDV used */ |
||||
FT_UInt lenBV; /* BlendV length (aka numMasters) */ |
||||
FT_Int32* BV; /* current blendV (per DICT/glyph) */ |
||||
|
||||
} CFF_BlendRec, *CFF_Blend; |
||||
|
||||
|
||||
typedef struct CFF_FontRecDictRec_ |
||||
{ |
||||
FT_UInt version; |
||||
FT_UInt notice; |
||||
FT_UInt copyright; |
||||
FT_UInt full_name; |
||||
FT_UInt family_name; |
||||
FT_UInt weight; |
||||
FT_Bool is_fixed_pitch; |
||||
FT_Fixed italic_angle; |
||||
FT_Fixed underline_position; |
||||
FT_Fixed underline_thickness; |
||||
FT_Int paint_type; |
||||
FT_Int charstring_type; |
||||
FT_Matrix font_matrix; |
||||
FT_Bool has_font_matrix; |
||||
FT_ULong units_per_em; /* temporarily used as scaling value also */ |
||||
FT_Vector font_offset; |
||||
FT_ULong unique_id; |
||||
FT_BBox font_bbox; |
||||
FT_Pos stroke_width; |
||||
FT_ULong charset_offset; |
||||
FT_ULong encoding_offset; |
||||
FT_ULong charstrings_offset; |
||||
FT_ULong private_offset; |
||||
FT_ULong private_size; |
||||
FT_Long synthetic_base; |
||||
FT_UInt embedded_postscript; |
||||
|
||||
/* these should only be used for the top-level font dictionary */ |
||||
FT_UInt cid_registry; |
||||
FT_UInt cid_ordering; |
||||
FT_Long cid_supplement; |
||||
|
||||
FT_Long cid_font_version; |
||||
FT_Long cid_font_revision; |
||||
FT_Long cid_font_type; |
||||
FT_ULong cid_count; |
||||
FT_ULong cid_uid_base; |
||||
FT_ULong cid_fd_array_offset; |
||||
FT_ULong cid_fd_select_offset; |
||||
FT_UInt cid_font_name; |
||||
|
||||
/* the next fields come from the data of the deprecated */ |
||||
/* `MultipleMaster' operator; they are needed to parse the (also */ |
||||
/* deprecated) `blend' operator in Type 2 charstrings */ |
||||
FT_UShort num_designs; |
||||
FT_UShort num_axes; |
||||
|
||||
/* fields for CFF2 */ |
||||
FT_ULong vstore_offset; |
||||
FT_UInt maxstack; |
||||
|
||||
} CFF_FontRecDictRec, *CFF_FontRecDict; |
||||
|
||||
|
||||
/* forward reference */ |
||||
typedef struct CFF_SubFontRec_* CFF_SubFont; |
||||
|
||||
|
||||
typedef struct CFF_PrivateRec_ |
||||
{ |
||||
FT_Byte num_blue_values; |
||||
FT_Byte num_other_blues; |
||||
FT_Byte num_family_blues; |
||||
FT_Byte num_family_other_blues; |
||||
|
||||
FT_Pos blue_values[14]; |
||||
FT_Pos other_blues[10]; |
||||
FT_Pos family_blues[14]; |
||||
FT_Pos family_other_blues[10]; |
||||
|
||||
FT_Fixed blue_scale; |
||||
FT_Pos blue_shift; |
||||
FT_Pos blue_fuzz; |
||||
FT_Pos standard_width; |
||||
FT_Pos standard_height; |
||||
|
||||
FT_Byte num_snap_widths; |
||||
FT_Byte num_snap_heights; |
||||
FT_Pos snap_widths[13]; |
||||
FT_Pos snap_heights[13]; |
||||
FT_Bool force_bold; |
||||
FT_Fixed force_bold_threshold; |
||||
FT_Int lenIV; |
||||
FT_Int language_group; |
||||
FT_Fixed expansion_factor; |
||||
FT_Long initial_random_seed; |
||||
FT_ULong local_subrs_offset; |
||||
FT_Pos default_width; |
||||
FT_Pos nominal_width; |
||||
|
||||
/* fields for CFF2 */ |
||||
FT_UInt vsindex; |
||||
CFF_SubFont subfont; |
||||
|
||||
} CFF_PrivateRec, *CFF_Private; |
||||
|
||||
|
||||
typedef struct CFF_FDSelectRec_ |
||||
{ |
||||
FT_Byte format; |
||||
FT_UInt range_count; |
||||
|
||||
/* that's the table, taken from the file `as is' */ |
||||
FT_Byte* data; |
||||
FT_UInt data_size; |
||||
|
||||
/* small cache for format 3 only */ |
||||
FT_UInt cache_first; |
||||
FT_UInt cache_count; |
||||
FT_Byte cache_fd; |
||||
|
||||
} CFF_FDSelectRec, *CFF_FDSelect; |
||||
|
||||
|
||||
/* A SubFont packs a font dict and a private dict together. They are */ |
||||
/* needed to support CID-keyed CFF fonts. */ |
||||
typedef struct CFF_SubFontRec_ |
||||
{ |
||||
CFF_FontRecDictRec font_dict; |
||||
CFF_PrivateRec private_dict; |
||||
|
||||
/* fields for CFF2 */ |
||||
CFF_BlendRec blend; /* current blend vector */ |
||||
FT_UInt lenNDV; /* current length NDV or zero */ |
||||
FT_Fixed* NDV; /* ptr to current NDV or NULL */ |
||||
|
||||
/* `blend_stack' is a writable buffer to hold blend results. */ |
||||
/* This buffer is to the side of the normal cff parser stack; */ |
||||
/* `cff_parse_blend' and `cff_blend_doBlend' push blend results here. */ |
||||
/* The normal stack then points to these values instead of the DICT */ |
||||
/* because all other operators in Private DICT clear the stack. */ |
||||
/* `blend_stack' could be cleared at each operator other than blend. */ |
||||
/* Blended values are stored as 5-byte fixed-point values. */ |
||||
|
||||
FT_Byte* blend_stack; /* base of stack allocation */ |
||||
FT_Byte* blend_top; /* first empty slot */ |
||||
FT_UInt blend_used; /* number of bytes in use */ |
||||
FT_UInt blend_alloc; /* number of bytes allocated */ |
||||
|
||||
CFF_IndexRec local_subrs_index; |
||||
FT_Byte** local_subrs; /* array of pointers */ |
||||
/* into Local Subrs INDEX data */ |
||||
|
||||
FT_UInt32 random; |
||||
|
||||
} CFF_SubFontRec; |
||||
|
||||
|
||||
#define CFF_MAX_CID_FONTS 256 |
||||
|
||||
|
||||
typedef struct CFF_FontRec_ |
||||
{ |
||||
FT_Library library; |
||||
FT_Stream stream; |
||||
FT_Memory memory; /* TODO: take this from stream->memory? */ |
||||
FT_ULong base_offset; /* offset to start of CFF */ |
||||
FT_UInt num_faces; |
||||
FT_UInt num_glyphs; |
||||
|
||||
FT_Byte version_major; |
||||
FT_Byte version_minor; |
||||
FT_Byte header_size; |
||||
|
||||
FT_UInt top_dict_length; /* cff2 only */ |
||||
|
||||
FT_Bool cff2; |
||||
|
||||
CFF_IndexRec name_index; |
||||
CFF_IndexRec top_dict_index; |
||||
CFF_IndexRec global_subrs_index; |
||||
|
||||
CFF_EncodingRec encoding; |
||||
CFF_CharsetRec charset; |
||||
|
||||
CFF_IndexRec charstrings_index; |
||||
CFF_IndexRec font_dict_index; |
||||
CFF_IndexRec private_index; |
||||
CFF_IndexRec local_subrs_index; |
||||
|
||||
FT_String* font_name; |
||||
|
||||
/* array of pointers into Global Subrs INDEX data */ |
||||
FT_Byte** global_subrs; |
||||
|
||||
/* array of pointers into String INDEX data stored at string_pool */ |
||||
FT_UInt num_strings; |
||||
FT_Byte** strings; |
||||
FT_Byte* string_pool; |
||||
FT_ULong string_pool_size; |
||||
|
||||
CFF_SubFontRec top_font; |
||||
FT_UInt num_subfonts; |
||||
CFF_SubFont subfonts[CFF_MAX_CID_FONTS]; |
||||
|
||||
CFF_FDSelectRec fd_select; |
||||
|
||||
/* interface to PostScript hinter */ |
||||
PSHinter_Service pshinter; |
||||
|
||||
/* interface to Postscript Names service */ |
||||
FT_Service_PsCMaps psnames; |
||||
|
||||
/* interface to CFFLoad service */ |
||||
const void* cffload; |
||||
|
||||
/* since version 2.3.0 */ |
||||
PS_FontInfoRec* font_info; /* font info dictionary */ |
||||
|
||||
/* since version 2.3.6 */ |
||||
FT_String* registry; |
||||
FT_String* ordering; |
||||
|
||||
/* since version 2.4.12 */ |
||||
FT_Generic cf2_instance; |
||||
|
||||
/* since version 2.7.1 */ |
||||
CFF_VStoreRec vstore; /* parsed vstore structure */ |
||||
|
||||
/* since version 2.9 */ |
||||
PS_FontExtraRec* font_extra; |
||||
|
||||
} CFF_FontRec; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* CFFTYPES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,343 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* internal/compiler-macros.h |
||||
* |
||||
* Compiler-specific macro definitions used internally by FreeType. |
||||
* |
||||
* Copyright (C) 2020-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef INTERNAL_COMPILER_MACROS_H_ |
||||
#define INTERNAL_COMPILER_MACROS_H_ |
||||
|
||||
#include <freetype/config/public-macros.h> |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/* Fix compiler warning with sgi compiler. */ |
||||
#if defined( __sgi ) && !defined( __GNUC__ ) |
||||
# if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 ) |
||||
# pragma set woff 3505 |
||||
# endif |
||||
#endif |
||||
|
||||
/* Fix compiler warning with sgi compiler. */ |
||||
#if defined( __sgi ) && !defined( __GNUC__ ) |
||||
# if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 ) |
||||
# pragma set woff 3505 |
||||
# endif |
||||
#endif |
||||
|
||||
/* Newer compilers warn for fall-through case statements. */ |
||||
#ifndef FALL_THROUGH |
||||
# if ( defined( __STDC_VERSION__ ) && __STDC_VERSION__ > 201710L ) || \ |
||||
( defined( __cplusplus ) && __cplusplus > 201402L ) |
||||
# define FALL_THROUGH [[__fallthrough__]] |
||||
# elif ( defined( __GNUC__ ) && __GNUC__ >= 7 ) || \ |
||||
( defined( __clang__ ) && \
|
||||
( defined( __apple_build_version__ ) \
|
||||
? __apple_build_version__ >= 12000000 \
|
||||
: __clang_major__ >= 10 ) ) |
||||
# define FALL_THROUGH __attribute__(( __fallthrough__ )) |
||||
# else |
||||
# define FALL_THROUGH ( (void)0 ) |
||||
# endif |
||||
#endif |
||||
|
||||
/*
|
||||
* When defining a macro that expands to a non-trivial C statement, use |
||||
* FT_BEGIN_STMNT and FT_END_STMNT to enclose the macro's body. This |
||||
* ensures there are no surprises when the macro is invoked in conditional |
||||
* branches. |
||||
* |
||||
* Example: |
||||
* |
||||
* #define LOG( ... ) \
|
||||
* FT_BEGIN_STMNT \
|
||||
* if ( logging_enabled ) \
|
||||
* log( __VA_ARGS__ ); \
|
||||
* FT_END_STMNT |
||||
*/ |
||||
#define FT_BEGIN_STMNT do { |
||||
#define FT_END_STMNT } while ( 0 ) |
||||
|
||||
/*
|
||||
* FT_DUMMY_STMNT expands to an empty C statement. Useful for |
||||
* conditionally defined statement macros. |
||||
* |
||||
* Example: |
||||
* |
||||
* #ifdef BUILD_CONFIG_LOGGING |
||||
* #define LOG( ... ) \
|
||||
* FT_BEGIN_STMNT \
|
||||
* if ( logging_enabled ) \
|
||||
* log( __VA_ARGS__ ); \
|
||||
* FT_END_STMNT |
||||
* #else |
||||
* # define LOG( ... ) FT_DUMMY_STMNT |
||||
* #endif |
||||
*/ |
||||
#define FT_DUMMY_STMNT FT_BEGIN_STMNT FT_END_STMNT |
||||
|
||||
#ifdef __UINTPTR_TYPE__ |
||||
/*
|
||||
* GCC and Clang both provide a `__UINTPTR_TYPE__` that can be used to |
||||
* avoid a dependency on `stdint.h`. |
||||
*/ |
||||
# define FT_UINT_TO_POINTER( x ) (void *)(__UINTPTR_TYPE__)(x) |
||||
#elif defined( _WIN64 ) |
||||
/* only 64bit Windows uses the LLP64 data model, i.e., */ |
||||
/* 32-bit integers, 64-bit pointers. */ |
||||
# define FT_UINT_TO_POINTER( x ) (void *)(unsigned __int64)(x) |
||||
#else |
||||
# define FT_UINT_TO_POINTER( x ) (void *)(unsigned long)(x) |
||||
#endif |
||||
|
||||
/*
|
||||
* Use `FT_TYPEOF( type )` to cast a value to `type`. This is useful to |
||||
* suppress signedness compilation warnings in macros. |
||||
* |
||||
* Example: |
||||
* |
||||
* #define PAD_( x, n ) ( (x) & ~FT_TYPEOF( x )( (n) - 1 ) ) |
||||
* |
||||
* (The `typeof` condition is taken from gnulib's `intprops.h` header |
||||
* file.) |
||||
*/ |
||||
#if ( ( defined( __GNUC__ ) && __GNUC__ >= 2 ) || \ |
||||
( defined( __IBMC__ ) && __IBMC__ >= 1210 && \
|
||||
defined( __IBM__TYPEOF__ ) ) || \
|
||||
( defined( __SUNPRO_C ) && __SUNPRO_C >= 0x5110 && !__STDC__ ) ) |
||||
#define FT_TYPEOF( type ) ( __typeof__ ( type ) ) |
||||
#else |
||||
#define FT_TYPEOF( type ) /* empty */ |
||||
#endif |
||||
|
||||
/*
|
||||
* Mark a function declaration as internal to the library. This ensures |
||||
* that it will not be exposed by default to client code, and helps |
||||
* generate smaller and faster code on ELF-based platforms. Place this |
||||
* before a function declaration. |
||||
*/ |
||||
|
||||
/* Visual C, mingw */ |
||||
#if defined( _WIN32 ) |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE /* empty */ |
||||
|
||||
/* gcc, clang */ |
||||
#elif ( defined( __GNUC__ ) && __GNUC__ >= 4 ) || defined( __clang__ ) |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE \ |
||||
__attribute__(( visibility( "hidden" ) )) |
||||
|
||||
/* Sun */ |
||||
#elif defined( __SUNPRO_C ) && __SUNPRO_C >= 0x550 |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE __hidden |
||||
|
||||
#else |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE /* empty */ |
||||
#endif |
||||
|
||||
/*
|
||||
* FreeType supports compilation of its C sources with a C++ compiler (in |
||||
* C++ mode); this introduces a number of subtle issues. |
||||
* |
||||
* The main one is that a C++ function declaration and its definition must |
||||
* have the same 'linkage'. Because all FreeType headers declare their |
||||
* functions with C linkage (i.e., within an `extern "C" { ... }` block |
||||
* due to the magic of FT_BEGIN_HEADER and FT_END_HEADER), their |
||||
* definition in FreeType sources should also be prefixed with `extern |
||||
* "C"` when compiled in C++ mode. |
||||
* |
||||
* The `FT_FUNCTION_DECLARATION` and `FT_FUNCTION_DEFINITION` macros are |
||||
* provided to deal with this case, as well as `FT_CALLBACK_DEF` and its |
||||
* siblings below. |
||||
*/ |
||||
|
||||
/*
|
||||
* `FT_FUNCTION_DECLARATION( type )` can be used to write a C function |
||||
* declaration to ensure it will have C linkage when the library is built |
||||
* with a C++ compiler. The parameter is the function's return type, so a |
||||
* declaration would look like |
||||
* |
||||
* FT_FUNCTION_DECLARATION( int ) |
||||
* foo( int x ); |
||||
* |
||||
* NOTE: This requires that all uses are inside of `FT_BEGIN_HEADER ... |
||||
* FT_END_HEADER` blocks, which guarantees that the declarations have C |
||||
* linkage when the headers are included by C++ sources. |
||||
* |
||||
* NOTE: Do not use directly. Use `FT_LOCAL`, `FT_BASE`, and `FT_EXPORT` |
||||
* instead. |
||||
*/ |
||||
#define FT_FUNCTION_DECLARATION( x ) extern x |
||||
|
||||
/*
|
||||
* Same as `FT_FUNCTION_DECLARATION`, but for function definitions instead. |
||||
* |
||||
* NOTE: Do not use directly. Use `FT_LOCAL_DEF`, `FT_BASE_DEF`, and |
||||
* `FT_EXPORT_DEF` instead. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
#define FT_FUNCTION_DEFINITION( x ) extern "C" x |
||||
#else |
||||
#define FT_FUNCTION_DEFINITION( x ) x |
||||
#endif |
||||
|
||||
/*
|
||||
* Use `FT_LOCAL` and `FT_LOCAL_DEF` to declare and define, respectively, |
||||
* an internal FreeType function that is only used by the sources of a |
||||
* single `src/module/` directory. This ensures that the functions are |
||||
* turned into static ones at build time, resulting in smaller and faster |
||||
* code. |
||||
*/ |
||||
#ifdef FT_MAKE_OPTION_SINGLE_OBJECT |
||||
|
||||
#define FT_LOCAL( x ) static x |
||||
#define FT_LOCAL_DEF( x ) static x |
||||
|
||||
#else |
||||
|
||||
#define FT_LOCAL( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE \ |
||||
FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_LOCAL_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
#endif /* FT_MAKE_OPTION_SINGLE_OBJECT */ |
||||
|
||||
/*
|
||||
* Use `FT_LOCAL_ARRAY` and `FT_LOCAL_ARRAY_DEF` to declare and define, |
||||
* respectively, a constant array that must be accessed from several |
||||
* sources in the same `src/module/` sub-directory, and which are internal |
||||
* to the library. |
||||
*/ |
||||
#define FT_LOCAL_ARRAY( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE \ |
||||
extern const x |
||||
#define FT_LOCAL_ARRAY_DEF( x ) FT_FUNCTION_DEFINITION( const x ) |
||||
|
||||
/*
|
||||
* `Use FT_BASE` and `FT_BASE_DEF` to declare and define, respectively, an |
||||
* internal library function that is used by more than a single module. |
||||
*/ |
||||
#define FT_BASE( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE \ |
||||
FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_BASE_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
|
||||
/*
|
||||
* NOTE: Conditionally define `FT_EXPORT_VAR` due to its definition in |
||||
* `src/smooth/ftgrays.h` to make the header more portable. |
||||
*/ |
||||
#ifndef FT_EXPORT_VAR |
||||
#define FT_EXPORT_VAR( x ) FT_FUNCTION_DECLARATION( x ) |
||||
#endif |
||||
|
||||
/*
|
||||
* When compiling FreeType as a DLL or DSO with hidden visibility, |
||||
* some systems/compilers need a special attribute in front OR after |
||||
* the return type of function declarations. |
||||
* |
||||
* Two macros are used within the FreeType source code to define |
||||
* exported library functions: `FT_EXPORT` and `FT_EXPORT_DEF`. |
||||
* |
||||
* - `FT_EXPORT( return_type )` |
||||
* |
||||
* is used in a function declaration, as in |
||||
* |
||||
* ``` |
||||
* FT_EXPORT( FT_Error ) |
||||
* FT_Init_FreeType( FT_Library* alibrary ); |
||||
* ``` |
||||
* |
||||
* - `FT_EXPORT_DEF( return_type )` |
||||
* |
||||
* is used in a function definition, as in |
||||
* |
||||
* ``` |
||||
* FT_EXPORT_DEF( FT_Error ) |
||||
* FT_Init_FreeType( FT_Library* alibrary ) |
||||
* { |
||||
* ... some code ... |
||||
* return FT_Err_Ok; |
||||
* } |
||||
* ``` |
||||
* |
||||
* You can provide your own implementation of `FT_EXPORT` and |
||||
* `FT_EXPORT_DEF` here if you want. |
||||
* |
||||
* To export a variable, use `FT_EXPORT_VAR`. |
||||
*/ |
||||
|
||||
/* See `freetype/config/public-macros.h` for the `FT_EXPORT` definition */ |
||||
#define FT_EXPORT_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
/*
|
||||
* The following macros are needed to compile the library with a |
||||
* C++ compiler and with 16bit compilers. |
||||
*/ |
||||
|
||||
/*
|
||||
* This is special. Within C++, you must specify `extern "C"` for |
||||
* functions which are used via function pointers, and you also |
||||
* must do that for structures which contain function pointers to |
||||
* assure C linkage -- it's not possible to have (local) anonymous |
||||
* functions which are accessed by (global) function pointers. |
||||
* |
||||
* |
||||
* FT_CALLBACK_DEF is used to _define_ a callback function, |
||||
* located in the same source code file as the structure that uses |
||||
* it. FT_COMPARE_DEF, in addition, ensures the `cdecl` calling |
||||
* convention on x86, required by the C library function `qsort`. |
||||
* |
||||
* FT_BASE_CALLBACK and FT_BASE_CALLBACK_DEF are used to declare |
||||
* and define a callback function, respectively, in a similar way |
||||
* as FT_BASE and FT_BASE_DEF work. |
||||
* |
||||
* FT_CALLBACK_TABLE is used to _declare_ a constant variable that |
||||
* contains pointers to callback functions. |
||||
* |
||||
* FT_CALLBACK_TABLE_DEF is used to _define_ a constant variable |
||||
* that contains pointers to callback functions. |
||||
* |
||||
* |
||||
* Some 16bit compilers have to redefine these macros to insert |
||||
* the infamous `_cdecl` or `__fastcall` declarations. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_CALLBACK_DEF( x ) static x |
||||
#endif |
||||
|
||||
#if defined( __GNUC__ ) && defined( __i386__ ) |
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __attribute__(( cdecl )) |
||||
#elif defined( _MSC_VER ) && defined( _M_IX86 ) |
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __cdecl |
||||
#elif defined( __WATCOMC__ ) && __WATCOMC__ >= 1240 |
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __watcall |
||||
#else |
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) |
||||
#endif |
||||
|
||||
#define FT_BASE_CALLBACK( x ) FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_BASE_CALLBACK_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
#ifndef FT_CALLBACK_TABLE |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_TABLE extern "C" |
||||
#define FT_CALLBACK_TABLE_DEF extern "C" |
||||
#else |
||||
#define FT_CALLBACK_TABLE extern |
||||
#define FT_CALLBACK_TABLE_DEF /* nothing */ |
||||
#endif |
||||
#endif /* FT_CALLBACK_TABLE */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* INTERNAL_COMPILER_MACROS_H_ */ |
||||
@ -0,0 +1,581 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftcalc.h |
||||
* |
||||
* Arithmetic computations (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTCALC_H_ |
||||
#define FTCALC_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* FT_MulDiv() and FT_MulFix() are declared in freetype.h. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef FT_CONFIG_OPTION_NO_ASSEMBLER |
||||
/* Provide assembler fragments for performance-critical functions. */ |
||||
/* These must be defined `static __inline__' with GCC. */ |
||||
|
||||
#if defined( __CC_ARM ) || defined( __ARMCC__ ) /* RVCT */ |
||||
|
||||
#define FT_MULFIX_ASSEMBLER FT_MulFix_arm |
||||
|
||||
/* documentation is in freetype.h */ |
||||
|
||||
static __inline FT_Int32 |
||||
FT_MulFix_arm( FT_Int32 a, |
||||
FT_Int32 b ) |
||||
{ |
||||
FT_Int32 t, t2; |
||||
|
||||
|
||||
__asm |
||||
{ |
||||
smull t2, t, b, a /* (lo=t2,hi=t) = a*b */ |
||||
mov a, t, asr #31 /* a = (hi >> 31) */ |
||||
add a, a, #0x8000 /* a += 0x8000 */ |
||||
adds t2, t2, a /* t2 += a */ |
||||
adc t, t, #0 /* t += carry */ |
||||
mov a, t2, lsr #16 /* a = t2 >> 16 */ |
||||
orr a, a, t, lsl #16 /* a |= t << 16 */ |
||||
} |
||||
return a; |
||||
} |
||||
|
||||
#endif /* __CC_ARM || __ARMCC__ */ |
||||
|
||||
|
||||
#ifdef __GNUC__ |
||||
|
||||
#if defined( __arm__ ) && \ |
||||
( !defined( __thumb__ ) || defined( __thumb2__ ) ) && \
|
||||
!( defined( __CC_ARM ) || defined( __ARMCC__ ) ) |
||||
|
||||
#define FT_MULFIX_ASSEMBLER FT_MulFix_arm |
||||
|
||||
/* documentation is in freetype.h */ |
||||
|
||||
static __inline__ FT_Int32 |
||||
FT_MulFix_arm( FT_Int32 a, |
||||
FT_Int32 b ) |
||||
{ |
||||
FT_Int32 t, t2; |
||||
|
||||
|
||||
__asm__ __volatile__ ( |
||||
"smull %1, %2, %4, %3\n\t" /* (lo=%1,hi=%2) = a*b */ |
||||
"mov %0, %2, asr #31\n\t" /* %0 = (hi >> 31) */ |
||||
#if defined( __clang__ ) && defined( __thumb2__ ) |
||||
"add.w %0, %0, #0x8000\n\t" /* %0 += 0x8000 */ |
||||
#else |
||||
"add %0, %0, #0x8000\n\t" /* %0 += 0x8000 */ |
||||
#endif |
||||
"adds %1, %1, %0\n\t" /* %1 += %0 */ |
||||
"adc %2, %2, #0\n\t" /* %2 += carry */ |
||||
"mov %0, %1, lsr #16\n\t" /* %0 = %1 >> 16 */ |
||||
"orr %0, %0, %2, lsl #16\n\t" /* %0 |= %2 << 16 */ |
||||
: "=r"(a), "=&r"(t2), "=&r"(t) |
||||
: "r"(a), "r"(b) |
||||
: "cc" ); |
||||
return a; |
||||
} |
||||
|
||||
#endif /* __arm__ && */ |
||||
/* ( __thumb2__ || !__thumb__ ) && */ |
||||
/* !( __CC_ARM || __ARMCC__ ) */ |
||||
|
||||
|
||||
#if defined( __i386__ ) |
||||
|
||||
#define FT_MULFIX_ASSEMBLER FT_MulFix_i386 |
||||
|
||||
/* documentation is in freetype.h */ |
||||
|
||||
static __inline__ FT_Int32 |
||||
FT_MulFix_i386( FT_Int32 a, |
||||
FT_Int32 b ) |
||||
{ |
||||
FT_Int32 result; |
||||
|
||||
|
||||
__asm__ __volatile__ ( |
||||
"imul %%edx\n" |
||||
"movl %%edx, %%ecx\n" |
||||
"sarl $31, %%ecx\n" |
||||
"addl $0x8000, %%ecx\n" |
||||
"addl %%ecx, %%eax\n" |
||||
"adcl $0, %%edx\n" |
||||
"shrl $16, %%eax\n" |
||||
"shll $16, %%edx\n" |
||||
"addl %%edx, %%eax\n" |
||||
: "=a"(result), "=d"(b) |
||||
: "a"(a), "d"(b) |
||||
: "%ecx", "cc" ); |
||||
return result; |
||||
} |
||||
|
||||
#endif /* i386 */ |
||||
|
||||
#endif /* __GNUC__ */ |
||||
|
||||
|
||||
#ifdef _MSC_VER /* Visual C++ */ |
||||
|
||||
#ifdef _M_IX86 |
||||
|
||||
#define FT_MULFIX_ASSEMBLER FT_MulFix_i386 |
||||
|
||||
/* documentation is in freetype.h */ |
||||
|
||||
static __inline FT_Int32 |
||||
FT_MulFix_i386( FT_Int32 a, |
||||
FT_Int32 b ) |
||||
{ |
||||
FT_Int32 result; |
||||
|
||||
__asm |
||||
{ |
||||
mov eax, a |
||||
mov edx, b |
||||
imul edx |
||||
mov ecx, edx |
||||
sar ecx, 31 |
||||
add ecx, 8000h |
||||
add eax, ecx |
||||
adc edx, 0 |
||||
shr eax, 16 |
||||
shl edx, 16 |
||||
add eax, edx |
||||
mov result, eax |
||||
} |
||||
return result; |
||||
} |
||||
|
||||
#endif /* _M_IX86 */ |
||||
|
||||
#endif /* _MSC_VER */ |
||||
|
||||
|
||||
#if defined( __GNUC__ ) && defined( __x86_64__ ) |
||||
|
||||
#define FT_MULFIX_ASSEMBLER FT_MulFix_x86_64 |
||||
|
||||
static __inline__ FT_Int32 |
||||
FT_MulFix_x86_64( FT_Int32 a, |
||||
FT_Int32 b ) |
||||
{ |
||||
/* Temporarily disable the warning that C90 doesn't support */ |
||||
/* `long long'. */ |
||||
#if __GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 6 ) |
||||
#pragma GCC diagnostic push |
||||
#pragma GCC diagnostic ignored "-Wlong-long" |
||||
#endif |
||||
|
||||
#if 1 |
||||
/* Technically not an assembly fragment, but GCC does a really good */ |
||||
/* job at inlining it and generating good machine code for it. */ |
||||
long long ret, tmp; |
||||
|
||||
|
||||
ret = (long long)a * b; |
||||
tmp = ret >> 63; |
||||
ret += 0x8000 + tmp; |
||||
|
||||
return (FT_Int32)( ret >> 16 ); |
||||
#else |
||||
|
||||
/* For some reason, GCC 4.6 on Ubuntu 12.04 generates invalid machine */ |
||||
/* code from the lines below. The main issue is that `wide_a' is not */ |
||||
/* properly initialized by sign-extending `a'. Instead, the generated */ |
||||
/* machine code assumes that the register that contains `a' on input */ |
||||
/* can be used directly as a 64-bit value, which is wrong most of the */ |
||||
/* time. */ |
||||
long long wide_a = (long long)a; |
||||
long long wide_b = (long long)b; |
||||
long long result; |
||||
|
||||
|
||||
__asm__ __volatile__ ( |
||||
"imul %2, %1\n" |
||||
"mov %1, %0\n" |
||||
"sar $63, %0\n" |
||||
"lea 0x8000(%1, %0), %0\n" |
||||
"sar $16, %0\n" |
||||
: "=&r"(result), "=&r"(wide_a) |
||||
: "r"(wide_b) |
||||
: "cc" ); |
||||
|
||||
return (FT_Int32)result; |
||||
#endif |
||||
|
||||
#if __GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 6 ) |
||||
#pragma GCC diagnostic pop |
||||
#endif |
||||
} |
||||
|
||||
#endif /* __GNUC__ && __x86_64__ */ |
||||
|
||||
#endif /* !FT_CONFIG_OPTION_NO_ASSEMBLER */ |
||||
|
||||
|
||||
#ifdef FT_CONFIG_OPTION_INLINE_MULFIX |
||||
#ifdef FT_MULFIX_ASSEMBLER |
||||
#define FT_MulFix( a, b ) FT_MULFIX_ASSEMBLER( (FT_Int32)(a), (FT_Int32)(b) ) |
||||
#endif |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_MulDiv_No_Round |
||||
* |
||||
* @description: |
||||
* A very simple function used to perform the computation '(a*b)/c' |
||||
* (without rounding) with maximum accuracy (it uses a 64-bit |
||||
* intermediate integer whenever necessary). |
||||
* |
||||
* This function isn't necessarily as fast as some processor-specific |
||||
* operations, but is at least completely portable. |
||||
* |
||||
* @input: |
||||
* a :: |
||||
* The first multiplier. |
||||
* b :: |
||||
* The second multiplier. |
||||
* c :: |
||||
* The divisor. |
||||
* |
||||
* @return: |
||||
* The result of '(a*b)/c'. This function never traps when trying to |
||||
* divide by zero; it simply returns 'MaxInt' or 'MinInt' depending on |
||||
* the signs of 'a' and 'b'. |
||||
*/ |
||||
FT_BASE( FT_Long ) |
||||
FT_MulDiv_No_Round( FT_Long a, |
||||
FT_Long b, |
||||
FT_Long c ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_MulAddFix |
||||
* |
||||
* @description: |
||||
* Compute `(s[0] * f[0] + s[1] * f[1] + ...) / 0x10000`, where `s[n]` is |
||||
* usually a 16.16 scalar. |
||||
* |
||||
* @input: |
||||
* s :: |
||||
* The array of scalars. |
||||
* f :: |
||||
* The array of factors. |
||||
* count :: |
||||
* The number of entries in the array. |
||||
* |
||||
* @return: |
||||
* The result of `(s[0] * f[0] + s[1] * f[1] + ...) / 0x10000`. |
||||
* |
||||
* @note: |
||||
* This function is currently used for the scaled delta computation of |
||||
* variation stores. It internally uses 64-bit data types when |
||||
* available, otherwise it emulates 64-bit math by using 32-bit |
||||
* operations, which produce a correct result but most likely at a slower |
||||
* performance in comparison to the implementation base on `int64_t`. |
||||
* |
||||
*/ |
||||
FT_BASE( FT_Int32 ) |
||||
FT_MulAddFix( FT_Fixed* s, |
||||
FT_Int32* f, |
||||
FT_UInt count ); |
||||
|
||||
|
||||
/*
|
||||
* A variant of FT_Matrix_Multiply which scales its result afterwards. The |
||||
* idea is that both `a' and `b' are scaled by factors of 10 so that the |
||||
* values are as precise as possible to get a correct result during the |
||||
* 64bit multiplication. Let `sa' and `sb' be the scaling factors of `a' |
||||
* and `b', respectively, then the scaling factor of the result is `sa*sb'. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Matrix_Multiply_Scaled( const FT_Matrix* a, |
||||
FT_Matrix *b, |
||||
FT_Long scaling ); |
||||
|
||||
|
||||
/*
|
||||
* Check a matrix. If the transformation would lead to extreme shear or |
||||
* extreme scaling, for example, return 0. If everything is OK, return 1. |
||||
* |
||||
* Based on geometric considerations we use the following inequality to |
||||
* identify a degenerate matrix. |
||||
* |
||||
* 50 * abs(xx*yy - xy*yx) < xx^2 + xy^2 + yx^2 + yy^2 |
||||
* |
||||
* Value 50 is heuristic. |
||||
*/ |
||||
FT_BASE( FT_Bool ) |
||||
FT_Matrix_Check( const FT_Matrix* matrix ); |
||||
|
||||
|
||||
/*
|
||||
* A variant of FT_Vector_Transform. See comments for |
||||
* FT_Matrix_Multiply_Scaled. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Vector_Transform_Scaled( FT_Vector* vector, |
||||
const FT_Matrix* matrix, |
||||
FT_Long scaling ); |
||||
|
||||
|
||||
/*
|
||||
* This function normalizes a vector and returns its original length. The |
||||
* normalized vector is a 16.16 fixed-point unit vector with length close |
||||
* to 0x10000. The accuracy of the returned length is limited to 16 bits |
||||
* also. The function utilizes quick inverse square root approximation |
||||
* without divisions and square roots relying on Newton's iterations |
||||
* instead. |
||||
*/ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Vector_NormLen( FT_Vector* vector ); |
||||
|
||||
|
||||
/*
|
||||
* Return -1, 0, or +1, depending on the orientation of a given corner. We |
||||
* use the Cartesian coordinate system, with positive vertical values going |
||||
* upwards. The function returns +1 if the corner turns to the left, -1 to |
||||
* the right, and 0 for undecidable cases. |
||||
*/ |
||||
FT_BASE( FT_Int ) |
||||
ft_corner_orientation( FT_Pos in_x, |
||||
FT_Pos in_y, |
||||
FT_Pos out_x, |
||||
FT_Pos out_y ); |
||||
|
||||
|
||||
/*
|
||||
* Return TRUE if a corner is flat or nearly flat. This is equivalent to |
||||
* saying that the corner point is close to its neighbors, or inside an |
||||
* ellipse defined by the neighbor focal points to be more precise. |
||||
*/ |
||||
FT_BASE( FT_Int ) |
||||
ft_corner_is_flat( FT_Pos in_x, |
||||
FT_Pos in_y, |
||||
FT_Pos out_x, |
||||
FT_Pos out_y ); |
||||
|
||||
|
||||
/*
|
||||
* Return the most significant bit index. |
||||
*/ |
||||
|
||||
#ifndef FT_CONFIG_OPTION_NO_ASSEMBLER |
||||
|
||||
#if defined( __clang__ ) || ( defined( __GNUC__ ) && \ |
||||
( __GNUC__ > 3 || ( __GNUC__ == 3 && __GNUC_MINOR__ >= 4 ) ) ) |
||||
|
||||
#if FT_SIZEOF_INT == 4 |
||||
|
||||
#define FT_MSB( x ) ( 31 - __builtin_clz( x ) ) |
||||
|
||||
#elif FT_SIZEOF_LONG == 4 |
||||
|
||||
#define FT_MSB( x ) ( 31 - __builtin_clzl( x ) ) |
||||
|
||||
#endif |
||||
|
||||
#elif defined( _MSC_VER ) && _MSC_VER >= 1400 |
||||
|
||||
#if defined( _WIN32_WCE ) |
||||
|
||||
#include <cmnintrin.h> |
||||
#pragma intrinsic( _CountLeadingZeros ) |
||||
|
||||
#define FT_MSB( x ) ( 31 - _CountLeadingZeros( x ) ) |
||||
|
||||
#elif defined( _M_ARM64 ) || defined( _M_ARM ) |
||||
|
||||
#include <intrin.h> |
||||
#pragma intrinsic( _CountLeadingZeros ) |
||||
|
||||
#define FT_MSB( x ) ( 31 - _CountLeadingZeros( x ) ) |
||||
|
||||
#elif defined( _M_IX86 ) || defined( _M_AMD64 ) || defined( _M_IA64 ) |
||||
|
||||
#include <intrin.h> |
||||
#pragma intrinsic( _BitScanReverse ) |
||||
|
||||
static __inline FT_Int32 |
||||
FT_MSB_i386( FT_UInt32 x ) |
||||
{ |
||||
unsigned long where; |
||||
|
||||
|
||||
_BitScanReverse( &where, x ); |
||||
|
||||
return (FT_Int32)where; |
||||
} |
||||
|
||||
#define FT_MSB( x ) FT_MSB_i386( x ) |
||||
|
||||
#endif |
||||
|
||||
#elif defined( __WATCOMC__ ) && defined( __386__ ) |
||||
|
||||
extern __inline FT_Int32 |
||||
FT_MSB_i386( FT_UInt32 x ); |
||||
|
||||
#pragma aux FT_MSB_i386 = \ |
||||
"bsr eax, eax" \
|
||||
__parm [__eax] __nomemory \
|
||||
__value [__eax] \
|
||||
__modify __exact [__eax] __nomemory; |
||||
|
||||
#define FT_MSB( x ) FT_MSB_i386( x ) |
||||
|
||||
#elif defined( __DECC ) || defined( __DECCXX ) |
||||
|
||||
#include <builtins.h> |
||||
|
||||
#define FT_MSB( x ) (FT_Int)( 63 - _leadz( x ) ) |
||||
|
||||
#elif defined( _CRAYC ) |
||||
|
||||
#include <intrinsics.h> |
||||
|
||||
#define FT_MSB( x ) (FT_Int)( 31 - _leadz32( x ) ) |
||||
|
||||
#endif /* FT_MSB macro definitions */ |
||||
|
||||
#endif /* !FT_CONFIG_OPTION_NO_ASSEMBLER */ |
||||
|
||||
|
||||
#ifndef FT_MSB |
||||
|
||||
FT_BASE( FT_Int ) |
||||
FT_MSB( FT_UInt32 z ); |
||||
|
||||
#endif |
||||
|
||||
|
||||
/*
|
||||
* Return sqrt(x*x+y*y), which is the same as `FT_Vector_Length' but uses |
||||
* two fixed-point arguments instead. |
||||
*/ |
||||
FT_BASE( FT_Fixed ) |
||||
FT_Hypot( FT_Fixed x, |
||||
FT_Fixed y ); |
||||
|
||||
|
||||
#if 0 |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_SqrtFixed |
||||
* |
||||
* @description: |
||||
* Computes the square root of a 16.16 fixed-point value. |
||||
* |
||||
* @input: |
||||
* x :: |
||||
* The value to compute the root for. |
||||
* |
||||
* @return: |
||||
* The result of 'sqrt(x)'. |
||||
* |
||||
* @note: |
||||
* This function is not very fast. |
||||
*/ |
||||
FT_BASE( FT_Int32 ) |
||||
FT_SqrtFixed( FT_Int32 x ); |
||||
|
||||
#endif /* 0 */ |
||||
|
||||
|
||||
#define INT_TO_F26DOT6( x ) ( (FT_Long)(x) * 64 ) /* << 6 */ |
||||
#define INT_TO_F2DOT14( x ) ( (FT_Long)(x) * 16384 ) /* << 14 */ |
||||
#define INT_TO_FIXED( x ) ( (FT_Long)(x) * 65536 ) /* << 16 */ |
||||
#define F2DOT14_TO_FIXED( x ) ( (FT_Long)(x) * 4 ) /* << 2 */ |
||||
#define FIXED_TO_INT( x ) ( FT_RoundFix( x ) >> 16 ) |
||||
|
||||
#define ROUND_F26DOT6( x ) ( ( (x) + 32 - ( x < 0 ) ) & -64 ) |
||||
|
||||
/*
|
||||
* The following macros have two purposes. |
||||
* |
||||
* - Tag places where overflow is expected and harmless. |
||||
* |
||||
* - Avoid run-time sanitizer errors. |
||||
* |
||||
* Use with care! |
||||
*/ |
||||
#define ADD_INT( a, b ) \ |
||||
(FT_Int)( (FT_UInt)(a) + (FT_UInt)(b) ) |
||||
#define SUB_INT( a, b ) \ |
||||
(FT_Int)( (FT_UInt)(a) - (FT_UInt)(b) ) |
||||
#define MUL_INT( a, b ) \ |
||||
(FT_Int)( (FT_UInt)(a) * (FT_UInt)(b) ) |
||||
#define NEG_INT( a ) \ |
||||
(FT_Int)( (FT_UInt)0 - (FT_UInt)(a) ) |
||||
|
||||
#define ADD_LONG( a, b ) \ |
||||
(FT_Long)( (FT_ULong)(a) + (FT_ULong)(b) ) |
||||
#define SUB_LONG( a, b ) \ |
||||
(FT_Long)( (FT_ULong)(a) - (FT_ULong)(b) ) |
||||
#define MUL_LONG( a, b ) \ |
||||
(FT_Long)( (FT_ULong)(a) * (FT_ULong)(b) ) |
||||
#define NEG_LONG( a ) \ |
||||
(FT_Long)( (FT_ULong)0 - (FT_ULong)(a) ) |
||||
|
||||
#define ADD_INT32( a, b ) \ |
||||
(FT_Int32)( (FT_UInt32)(a) + (FT_UInt32)(b) ) |
||||
#define SUB_INT32( a, b ) \ |
||||
(FT_Int32)( (FT_UInt32)(a) - (FT_UInt32)(b) ) |
||||
#define MUL_INT32( a, b ) \ |
||||
(FT_Int32)( (FT_UInt32)(a) * (FT_UInt32)(b) ) |
||||
#define NEG_INT32( a ) \ |
||||
(FT_Int32)( (FT_UInt32)0 - (FT_UInt32)(a) ) |
||||
|
||||
#ifdef FT_INT64 |
||||
|
||||
#define ADD_INT64( a, b ) \ |
||||
(FT_Int64)( (FT_UInt64)(a) + (FT_UInt64)(b) ) |
||||
#define SUB_INT64( a, b ) \ |
||||
(FT_Int64)( (FT_UInt64)(a) - (FT_UInt64)(b) ) |
||||
#define MUL_INT64( a, b ) \ |
||||
(FT_Int64)( (FT_UInt64)(a) * (FT_UInt64)(b) ) |
||||
#define NEG_INT64( a ) \ |
||||
(FT_Int64)( (FT_UInt64)0 - (FT_UInt64)(a) ) |
||||
|
||||
#endif /* FT_INT64 */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTCALC_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,442 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftdebug.h |
||||
* |
||||
* Debugging and logging component (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
* |
||||
* IMPORTANT: A description of FreeType's debugging support can be |
||||
* found in 'docs/DEBUG.TXT'. Read it if you need to use or |
||||
* understand this code. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTDEBUG_H_ |
||||
#define FTDEBUG_H_ |
||||
|
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_CONFIG_H |
||||
#include <freetype/freetype.h> |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
#ifdef FT_DEBUG_LOGGING |
||||
#define DLG_STATIC |
||||
#include <dlg/output.h> |
||||
#include <dlg/dlg.h> |
||||
|
||||
#include <freetype/ftlogging.h> |
||||
#endif /* FT_DEBUG_LOGGING */ |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/* force the definition of FT_DEBUG_LEVEL_TRACE if FT_DEBUG_LOGGING is */ |
||||
/* already defined. */ |
||||
/* */ |
||||
#ifdef FT_DEBUG_LOGGING |
||||
#undef FT_DEBUG_LEVEL_TRACE |
||||
#define FT_DEBUG_LEVEL_TRACE |
||||
#endif |
||||
|
||||
/* force the definition of FT_DEBUG_LEVEL_ERROR if FT_DEBUG_LEVEL_TRACE */ |
||||
/* is already defined; this simplifies the following #ifdefs */ |
||||
/* */ |
||||
#ifdef FT_DEBUG_LEVEL_TRACE |
||||
#undef FT_DEBUG_LEVEL_ERROR |
||||
#define FT_DEBUG_LEVEL_ERROR |
||||
#endif |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Define the trace enums as well as the trace levels array when they are |
||||
* needed. |
||||
* |
||||
*/ |
||||
|
||||
#ifdef FT_DEBUG_LEVEL_TRACE |
||||
|
||||
#define FT_TRACE_DEF( x ) trace_ ## x , |
||||
|
||||
/* defining the enumeration */ |
||||
typedef enum FT_Trace_ |
||||
{ |
||||
#include <freetype/internal/fttrace.h> |
||||
trace_count |
||||
|
||||
} FT_Trace; |
||||
|
||||
|
||||
/* a pointer to the array of trace levels, */ |
||||
/* provided by `src/base/ftdebug.c' */ |
||||
extern int* ft_trace_levels; |
||||
|
||||
#undef FT_TRACE_DEF |
||||
|
||||
#endif /* FT_DEBUG_LEVEL_TRACE */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Define the FT_TRACE macro |
||||
* |
||||
* IMPORTANT! |
||||
* |
||||
* Each component must define the macro FT_COMPONENT to a valid FT_Trace |
||||
* value before using any TRACE macro. |
||||
* |
||||
* To get consistent logging output, there should be no newline character |
||||
* (i.e., '\n') or a single trailing one in the message string of |
||||
* `FT_TRACEx` and `FT_ERROR`. |
||||
*/ |
||||
|
||||
|
||||
/*************************************************************************
|
||||
* |
||||
* If FT_DEBUG_LOGGING is enabled, tracing messages are sent to dlg's API. |
||||
* If FT_DEBUG_LOGGING is disabled, tracing messages are sent to |
||||
* `FT_Message` (defined in ftdebug.c). |
||||
*/ |
||||
#ifdef FT_DEBUG_LOGGING |
||||
|
||||
/* we need two macros to convert the names of `FT_COMPONENT` to a string */ |
||||
#define FT_LOGGING_TAG( x ) FT_LOGGING_TAG_( x ) |
||||
#define FT_LOGGING_TAG_( x ) #x |
||||
|
||||
/* we need two macros to convert the component and the trace level */ |
||||
/* to a string that combines them */ |
||||
#define FT_LOGGING_TAGX( x, y ) FT_LOGGING_TAGX_( x, y ) |
||||
#define FT_LOGGING_TAGX_( x, y ) #x ":" #y |
||||
|
||||
|
||||
#define FT_LOG( level, varformat ) \ |
||||
do \
|
||||
{ \
|
||||
const char* dlg_tag = FT_LOGGING_TAGX( FT_COMPONENT, level ); \
|
||||
\
|
||||
\
|
||||
ft_add_tag( dlg_tag ); \
|
||||
if ( ft_trace_levels[FT_TRACE_COMP( FT_COMPONENT )] >= level ) \
|
||||
{ \
|
||||
if ( custom_output_handler != NULL ) \
|
||||
FT_Logging_Callback varformat; \
|
||||
else \
|
||||
dlg_trace varformat; \
|
||||
} \
|
||||
ft_remove_tag( dlg_tag ); \
|
||||
} while( 0 ) |
||||
|
||||
#else /* !FT_DEBUG_LOGGING */ |
||||
|
||||
#define FT_LOG( level, varformat ) \ |
||||
do \
|
||||
{ \
|
||||
if ( ft_trace_levels[FT_TRACE_COMP( FT_COMPONENT )] >= level ) \
|
||||
FT_Message varformat; \
|
||||
} while ( 0 ) |
||||
|
||||
#endif /* !FT_DEBUG_LOGGING */ |
||||
|
||||
|
||||
#ifdef FT_DEBUG_LEVEL_TRACE |
||||
|
||||
/* we need two macros here to make cpp expand `FT_COMPONENT' */ |
||||
#define FT_TRACE_COMP( x ) FT_TRACE_COMP_( x ) |
||||
#define FT_TRACE_COMP_( x ) trace_ ## x |
||||
|
||||
#define FT_TRACE( level, varformat ) FT_LOG( level, varformat ) |
||||
|
||||
#else /* !FT_DEBUG_LEVEL_TRACE */ |
||||
|
||||
#define FT_TRACE( level, varformat ) do { } while ( 0 ) /* nothing */ |
||||
|
||||
#endif /* !FT_DEBUG_LEVEL_TRACE */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Get_Count |
||||
* |
||||
* @description: |
||||
* Return the number of available trace components. |
||||
* |
||||
* @return: |
||||
* The number of trace components. 0 if FreeType 2 is not built with |
||||
* FT_DEBUG_LEVEL_TRACE definition. |
||||
* |
||||
* @note: |
||||
* This function may be useful if you want to access elements of the |
||||
* internal trace levels array by an index. |
||||
*/ |
||||
FT_BASE( FT_Int ) |
||||
FT_Trace_Get_Count( void ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Get_Name |
||||
* |
||||
* @description: |
||||
* Return the name of a trace component. |
||||
* |
||||
* @input: |
||||
* The index of the trace component. |
||||
* |
||||
* @return: |
||||
* The name of the trace component. This is a statically allocated |
||||
* C~string, so do not free it after use. `NULL` if FreeType is not |
||||
* built with FT_DEBUG_LEVEL_TRACE definition. |
||||
* |
||||
* @note: |
||||
* Use @FT_Trace_Get_Count to get the number of available trace |
||||
* components. |
||||
*/ |
||||
FT_BASE( const char* ) |
||||
FT_Trace_Get_Name( FT_Int idx ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Disable |
||||
* |
||||
* @description: |
||||
* Switch off tracing temporarily. It can be activated again with |
||||
* @FT_Trace_Enable. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Trace_Disable( void ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Trace_Enable |
||||
* |
||||
* @description: |
||||
* Activate tracing. Use it after tracing has been switched off with |
||||
* @FT_Trace_Disable. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Trace_Enable( void ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* You need two opening and closing parentheses! |
||||
* |
||||
* Example: FT_TRACE0(( "Value is %i", foo )) |
||||
* |
||||
* Output of the FT_TRACEX macros is sent to stderr. |
||||
* |
||||
*/ |
||||
|
||||
#define FT_TRACE0( varformat ) FT_TRACE( 0, varformat ) |
||||
#define FT_TRACE1( varformat ) FT_TRACE( 1, varformat ) |
||||
#define FT_TRACE2( varformat ) FT_TRACE( 2, varformat ) |
||||
#define FT_TRACE3( varformat ) FT_TRACE( 3, varformat ) |
||||
#define FT_TRACE4( varformat ) FT_TRACE( 4, varformat ) |
||||
#define FT_TRACE5( varformat ) FT_TRACE( 5, varformat ) |
||||
#define FT_TRACE6( varformat ) FT_TRACE( 6, varformat ) |
||||
#define FT_TRACE7( varformat ) FT_TRACE( 7, varformat ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Define the FT_ERROR macro. |
||||
* |
||||
* Output of this macro is sent to stderr. |
||||
* |
||||
*/ |
||||
|
||||
#ifdef FT_DEBUG_LEVEL_ERROR |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* If FT_DEBUG_LOGGING is enabled, error messages are sent to dlg's API. |
||||
* If FT_DEBUG_LOGGING is disabled, error messages are sent to `FT_Message` |
||||
* (defined in ftdebug.c). |
||||
* |
||||
*/ |
||||
#ifdef FT_DEBUG_LOGGING |
||||
|
||||
#define FT_ERROR( varformat ) \ |
||||
do \
|
||||
{ \
|
||||
const char* dlg_tag = FT_LOGGING_TAG( FT_COMPONENT ); \
|
||||
\
|
||||
\
|
||||
ft_add_tag( dlg_tag ); \
|
||||
dlg_trace varformat; \
|
||||
ft_remove_tag( dlg_tag ); \
|
||||
} while ( 0 ) |
||||
|
||||
#else /* !FT_DEBUG_LOGGING */ |
||||
|
||||
#define FT_ERROR( varformat ) FT_Message varformat |
||||
|
||||
#endif /* !FT_DEBUG_LOGGING */ |
||||
|
||||
|
||||
#else /* !FT_DEBUG_LEVEL_ERROR */ |
||||
|
||||
#define FT_ERROR( varformat ) do { } while ( 0 ) /* nothing */ |
||||
|
||||
#endif /* !FT_DEBUG_LEVEL_ERROR */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Define the FT_ASSERT and FT_THROW macros. The call to `FT_Throw` makes |
||||
* it possible to easily set a breakpoint at this function. |
||||
* |
||||
*/ |
||||
|
||||
#ifdef FT_DEBUG_LEVEL_ERROR |
||||
|
||||
#define FT_ASSERT( condition ) \ |
||||
do \
|
||||
{ \
|
||||
if ( !( condition ) ) \
|
||||
FT_Panic( "assertion failed on line %d of file %s\n", \
|
||||
__LINE__, __FILE__ ); \
|
||||
} while ( 0 ) |
||||
|
||||
#define FT_THROW( e ) \ |
||||
( FT_Throw( FT_ERR_CAT( FT_ERR_PREFIX, e ), \
|
||||
__LINE__, \
|
||||
__FILE__ ) | \
|
||||
FT_ERR_CAT( FT_ERR_PREFIX, e ) ) |
||||
|
||||
#else /* !FT_DEBUG_LEVEL_ERROR */ |
||||
|
||||
#define FT_ASSERT( condition ) do { } while ( 0 ) |
||||
|
||||
#define FT_THROW( e ) FT_ERR_CAT( FT_ERR_PREFIX, e ) |
||||
|
||||
#endif /* !FT_DEBUG_LEVEL_ERROR */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Define `FT_Message` and `FT_Panic` when needed. |
||||
* |
||||
*/ |
||||
|
||||
#ifdef FT_DEBUG_LEVEL_ERROR |
||||
|
||||
#include "stdio.h" /* for vfprintf() */ |
||||
|
||||
/* print a message */ |
||||
FT_BASE( void ) |
||||
FT_Message( const char* fmt, |
||||
... ); |
||||
|
||||
/* print a message and exit */ |
||||
FT_BASE( void ) |
||||
FT_Panic( const char* fmt, |
||||
... ); |
||||
|
||||
/* report file name and line number of an error */ |
||||
FT_BASE( int ) |
||||
FT_Throw( FT_Error error, |
||||
int line, |
||||
const char* file ); |
||||
|
||||
#endif /* FT_DEBUG_LEVEL_ERROR */ |
||||
|
||||
|
||||
FT_BASE( void ) |
||||
ft_debug_init( void ); |
||||
|
||||
|
||||
#ifdef FT_DEBUG_LOGGING |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* 'dlg' uses output handlers to control how and where log messages are |
||||
* printed. Therefore we need to define a default output handler for |
||||
* FreeType. |
||||
*/ |
||||
FT_BASE( void ) |
||||
ft_log_handler( const struct dlg_origin* origin, |
||||
const char* string, |
||||
void* data ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* 1. `ft_default_log_handler` stores the function pointer that is used |
||||
* internally by FreeType to print logs to a file. |
||||
* |
||||
* 2. `custom_output_handler` stores the function pointer to the callback |
||||
* function provided by the user. |
||||
* |
||||
* It is defined in `ftdebug.c`. |
||||
*/ |
||||
extern dlg_handler ft_default_log_handler; |
||||
extern FT_Custom_Log_Handler custom_output_handler; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* If FT_DEBUG_LOGGING macro is enabled, FreeType needs to initialize and |
||||
* un-initialize `FILE*`. |
||||
* |
||||
* These functions are defined in `ftdebug.c`. |
||||
*/ |
||||
FT_BASE( void ) |
||||
ft_logging_init( void ); |
||||
|
||||
FT_BASE( void ) |
||||
ft_logging_deinit( void ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* For printing the name of `FT_COMPONENT` along with the actual log we |
||||
* need to add a tag with the name of `FT_COMPONENT`. |
||||
* |
||||
* These functions are defined in `ftdebug.c`. |
||||
*/ |
||||
FT_BASE( void ) |
||||
ft_add_tag( const char* tag ); |
||||
|
||||
FT_BASE( void ) |
||||
ft_remove_tag( const char* tag ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* A function to print log data using a custom callback logging function |
||||
* (which is set using `FT_Set_Log_Handler`). |
||||
* |
||||
* This function is defined in `ftdebug.c`. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Logging_Callback( const char* fmt, |
||||
... ); |
||||
|
||||
#endif /* FT_DEBUG_LOGGING */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTDEBUG_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,289 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftdrv.h |
||||
* |
||||
* FreeType internal font driver interface (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTDRV_H_ |
||||
#define FTDRV_H_ |
||||
|
||||
|
||||
#include <freetype/ftmodapi.h> |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Face_InitFunc)( FT_Stream stream, |
||||
FT_Face face, |
||||
FT_Int typeface_index, |
||||
FT_Int num_params, |
||||
FT_Parameter* parameters ); |
||||
|
||||
typedef void |
||||
(*FT_Face_DoneFunc)( FT_Face face ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Size_InitFunc)( FT_Size size ); |
||||
|
||||
typedef void |
||||
(*FT_Size_DoneFunc)( FT_Size size ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Slot_InitFunc)( FT_GlyphSlot slot ); |
||||
|
||||
typedef void |
||||
(*FT_Slot_DoneFunc)( FT_GlyphSlot slot ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Size_RequestFunc)( FT_Size size, |
||||
FT_Size_Request req ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Size_SelectFunc)( FT_Size size, |
||||
FT_ULong size_index ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Slot_LoadFunc)( FT_GlyphSlot slot, |
||||
FT_Size size, |
||||
FT_UInt glyph_index, |
||||
FT_Int32 load_flags ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Face_GetKerningFunc)( FT_Face face, |
||||
FT_UInt left_glyph, |
||||
FT_UInt right_glyph, |
||||
FT_Vector* kerning ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Face_AttachFunc)( FT_Face face, |
||||
FT_Stream stream ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Face_GetAdvancesFunc)( FT_Face face, |
||||
FT_UInt first, |
||||
FT_UInt count, |
||||
FT_Int32 flags, |
||||
FT_Fixed* advances ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_Driver_ClassRec |
||||
* |
||||
* @description: |
||||
* The font driver class. This structure mostly contains pointers to |
||||
* driver methods. |
||||
* |
||||
* @fields: |
||||
* root :: |
||||
* The parent module. |
||||
* |
||||
* face_object_size :: |
||||
* The size of a face object in bytes. |
||||
* |
||||
* size_object_size :: |
||||
* The size of a size object in bytes. |
||||
* |
||||
* slot_object_size :: |
||||
* The size of a glyph object in bytes. |
||||
* |
||||
* init_face :: |
||||
* The format-specific face constructor. |
||||
* |
||||
* done_face :: |
||||
* The format-specific face destructor. |
||||
* |
||||
* init_size :: |
||||
* The format-specific size constructor. |
||||
* |
||||
* done_size :: |
||||
* The format-specific size destructor. |
||||
* |
||||
* init_slot :: |
||||
* The format-specific slot constructor. |
||||
* |
||||
* done_slot :: |
||||
* The format-specific slot destructor. |
||||
* |
||||
* |
||||
* load_glyph :: |
||||
* A function handle to load a glyph to a slot. This field is |
||||
* mandatory! |
||||
* |
||||
* get_kerning :: |
||||
* A function handle to return the unscaled kerning for a given pair of |
||||
* glyphs. Can be set to 0 if the format doesn't support kerning. |
||||
* |
||||
* attach_file :: |
||||
* This function handle is used to read additional data for a face from |
||||
* another file/stream. For example, this can be used to add data from |
||||
* AFM or PFM files on a Type 1 face, or a CIDMap on a CID-keyed face. |
||||
* |
||||
* get_advances :: |
||||
* A function handle used to return advance widths of 'count' glyphs |
||||
* (in font units), starting at 'first'. The 'vertical' flag must be |
||||
* set to get vertical advance heights. The 'advances' buffer is |
||||
* caller-allocated. The idea of this function is to be able to |
||||
* perform device-independent text layout without loading a single |
||||
* glyph image. |
||||
* |
||||
* request_size :: |
||||
* A handle to a function used to request the new character size. Can |
||||
* be set to 0 if the scaling done in the base layer suffices. |
||||
* |
||||
* select_size :: |
||||
* A handle to a function used to select a new fixed size. It is used |
||||
* only if @FT_FACE_FLAG_FIXED_SIZES is set. Can be set to 0 if the |
||||
* scaling done in the base layer suffices. |
||||
* |
||||
* @note: |
||||
* Most function pointers, with the exception of `load_glyph`, can be set |
||||
* to 0 to indicate a default behaviour. |
||||
*/ |
||||
typedef struct FT_Driver_ClassRec_ |
||||
{ |
||||
FT_Module_Class root; |
||||
|
||||
FT_Long face_object_size; |
||||
FT_Long size_object_size; |
||||
FT_Long slot_object_size; |
||||
|
||||
FT_Face_InitFunc init_face; |
||||
FT_Face_DoneFunc done_face; |
||||
|
||||
FT_Size_InitFunc init_size; |
||||
FT_Size_DoneFunc done_size; |
||||
|
||||
FT_Slot_InitFunc init_slot; |
||||
FT_Slot_DoneFunc done_slot; |
||||
|
||||
FT_Slot_LoadFunc load_glyph; |
||||
|
||||
FT_Face_GetKerningFunc get_kerning; |
||||
FT_Face_AttachFunc attach_file; |
||||
FT_Face_GetAdvancesFunc get_advances; |
||||
|
||||
/* since version 2.2 */ |
||||
FT_Size_RequestFunc request_size; |
||||
FT_Size_SelectFunc select_size; |
||||
|
||||
} FT_Driver_ClassRec, *FT_Driver_Class; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_DECLARE_DRIVER |
||||
* |
||||
* @description: |
||||
* Used to create a forward declaration of an FT_Driver_ClassRec struct |
||||
* instance. |
||||
* |
||||
* @macro: |
||||
* FT_DEFINE_DRIVER |
||||
* |
||||
* @description: |
||||
* Used to initialize an instance of FT_Driver_ClassRec struct. |
||||
* |
||||
* `ftinit.c` (ft_create_default_module_classes) already contains a |
||||
* mechanism to call these functions for the default modules described in |
||||
* `ftmodule.h`. |
||||
* |
||||
* The struct will be allocated in the global scope (or the scope where |
||||
* the macro is used). |
||||
*/ |
||||
#define FT_DECLARE_DRIVER( class_ ) \ |
||||
FT_CALLBACK_TABLE \
|
||||
const FT_Driver_ClassRec class_; |
||||
|
||||
#define FT_DEFINE_DRIVER( \ |
||||
class_, \
|
||||
flags_, \
|
||||
size_, \
|
||||
name_, \
|
||||
version_, \
|
||||
requires_, \
|
||||
interface_, \
|
||||
init_, \
|
||||
done_, \
|
||||
get_interface_, \
|
||||
face_object_size_, \
|
||||
size_object_size_, \
|
||||
slot_object_size_, \
|
||||
init_face_, \
|
||||
done_face_, \
|
||||
init_size_, \
|
||||
done_size_, \
|
||||
init_slot_, \
|
||||
done_slot_, \
|
||||
load_glyph_, \
|
||||
get_kerning_, \
|
||||
attach_file_, \
|
||||
get_advances_, \
|
||||
request_size_, \
|
||||
select_size_ ) \
|
||||
FT_CALLBACK_TABLE_DEF \
|
||||
const FT_Driver_ClassRec class_ = \
|
||||
{ \
|
||||
FT_DEFINE_ROOT_MODULE( flags_, \
|
||||
size_, \
|
||||
name_, \
|
||||
version_, \
|
||||
requires_, \
|
||||
interface_, \
|
||||
init_, \
|
||||
done_, \
|
||||
get_interface_ ) \
|
||||
\
|
||||
face_object_size_, \
|
||||
size_object_size_, \
|
||||
slot_object_size_, \
|
||||
\
|
||||
init_face_, \
|
||||
done_face_, \
|
||||
\
|
||||
init_size_, \
|
||||
done_size_, \
|
||||
\
|
||||
init_slot_, \
|
||||
done_slot_, \
|
||||
\
|
||||
load_glyph_, \
|
||||
\
|
||||
get_kerning_, \
|
||||
attach_file_, \
|
||||
get_advances_, \
|
||||
\
|
||||
request_size_, \
|
||||
select_size_ \
|
||||
}; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTDRV_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,147 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftgloadr.h |
||||
* |
||||
* The FreeType glyph loader (specification). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTGLOADR_H_ |
||||
#define FTGLOADR_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* FT_GlyphLoader |
||||
* |
||||
* @description: |
||||
* The glyph loader is an internal object used to load several glyphs |
||||
* together (for example, in the case of composites). |
||||
*/ |
||||
typedef struct FT_SubGlyphRec_ |
||||
{ |
||||
FT_Int index; |
||||
FT_UShort flags; |
||||
FT_Int arg1; |
||||
FT_Int arg2; |
||||
FT_Matrix transform; |
||||
|
||||
} FT_SubGlyphRec; |
||||
|
||||
|
||||
typedef struct FT_GlyphLoadRec_ |
||||
{ |
||||
FT_Outline outline; /* outline */ |
||||
FT_Vector* extra_points; /* extra points table */ |
||||
FT_Vector* extra_points2; /* second extra points table */ |
||||
FT_UInt num_subglyphs; /* number of subglyphs */ |
||||
FT_SubGlyph subglyphs; /* subglyphs */ |
||||
|
||||
} FT_GlyphLoadRec, *FT_GlyphLoad; |
||||
|
||||
|
||||
typedef struct FT_GlyphLoaderRec_ |
||||
{ |
||||
FT_Memory memory; |
||||
FT_UInt max_points; |
||||
FT_UInt max_contours; |
||||
FT_UInt max_subglyphs; |
||||
FT_Bool use_extra; |
||||
|
||||
FT_GlyphLoadRec base; |
||||
FT_GlyphLoadRec current; |
||||
|
||||
void* other; /* for possible future extension? */ |
||||
|
||||
} FT_GlyphLoaderRec, *FT_GlyphLoader; |
||||
|
||||
|
||||
/* create new empty glyph loader */ |
||||
FT_BASE( FT_Error ) |
||||
FT_GlyphLoader_New( FT_Memory memory, |
||||
FT_GlyphLoader *aloader ); |
||||
|
||||
/* add an extra points table to a glyph loader */ |
||||
FT_BASE( FT_Error ) |
||||
FT_GlyphLoader_CreateExtra( FT_GlyphLoader loader ); |
||||
|
||||
/* destroy a glyph loader */ |
||||
FT_BASE( void ) |
||||
FT_GlyphLoader_Done( FT_GlyphLoader loader ); |
||||
|
||||
/* reset a glyph loader (frees everything int it) */ |
||||
FT_BASE( void ) |
||||
FT_GlyphLoader_Reset( FT_GlyphLoader loader ); |
||||
|
||||
/* rewind a glyph loader */ |
||||
FT_BASE( void ) |
||||
FT_GlyphLoader_Rewind( FT_GlyphLoader loader ); |
||||
|
||||
/* check that there is enough space to add `n_points' and `n_contours' */ |
||||
/* to the glyph loader */ |
||||
FT_BASE( FT_Error ) |
||||
FT_GlyphLoader_CheckPoints( FT_GlyphLoader loader, |
||||
FT_UInt n_points, |
||||
FT_UInt n_contours ); |
||||
|
||||
|
||||
#define FT_GLYPHLOADER_CHECK_P( _loader, _count ) \ |
||||
( (_count) == 0 || \
|
||||
( (FT_UInt)(_loader)->base.outline.n_points + \
|
||||
(FT_UInt)(_loader)->current.outline.n_points + \
|
||||
(FT_UInt)(_count) ) <= (_loader)->max_points ) |
||||
|
||||
#define FT_GLYPHLOADER_CHECK_C( _loader, _count ) \ |
||||
( (_count) == 0 || \
|
||||
( (FT_UInt)(_loader)->base.outline.n_contours + \
|
||||
(FT_UInt)(_loader)->current.outline.n_contours + \
|
||||
(FT_UInt)(_count) ) <= (_loader)->max_contours ) |
||||
|
||||
#define FT_GLYPHLOADER_CHECK_POINTS( _loader, _points, _contours ) \ |
||||
( ( FT_GLYPHLOADER_CHECK_P( _loader, _points ) && \
|
||||
FT_GLYPHLOADER_CHECK_C( _loader, _contours ) ) \
|
||||
? 0 \
|
||||
: FT_GlyphLoader_CheckPoints( (_loader), \
|
||||
(FT_UInt)(_points), \
|
||||
(FT_UInt)(_contours) ) ) |
||||
|
||||
|
||||
/* check that there is enough space to add `n_subs' sub-glyphs to */ |
||||
/* a glyph loader */ |
||||
FT_BASE( FT_Error ) |
||||
FT_GlyphLoader_CheckSubGlyphs( FT_GlyphLoader loader, |
||||
FT_UInt n_subs ); |
||||
|
||||
/* prepare a glyph loader, i.e. empty the current glyph */ |
||||
FT_BASE( void ) |
||||
FT_GlyphLoader_Prepare( FT_GlyphLoader loader ); |
||||
|
||||
/* add the current glyph to the base glyph */ |
||||
FT_BASE( void ) |
||||
FT_GlyphLoader_Add( FT_GlyphLoader loader ); |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTGLOADR_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,135 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fthash.h |
||||
* |
||||
* Hashing functions (specification). |
||||
* |
||||
*/ |
||||
|
||||
/*
|
||||
* Copyright 2000 Computing Research Labs, New Mexico State University |
||||
* Copyright 2001-2015 |
||||
* Francesco Zappa Nardelli |
||||
* |
||||
* Permission is hereby granted, free of charge, to any person obtaining a |
||||
* copy of this software and associated documentation files (the "Software"), |
||||
* to deal in the Software without restriction, including without limitation |
||||
* the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
* and/or sell copies of the Software, and to permit persons to whom the |
||||
* Software is furnished to do so, subject to the following conditions: |
||||
* |
||||
* The above copyright notice and this permission notice shall be included in |
||||
* all copies or substantial portions of the Software. |
||||
* |
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
* THE COMPUTING RESEARCH LAB OR NEW MEXICO STATE UNIVERSITY BE LIABLE FOR ANY |
||||
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT |
||||
* OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR |
||||
* THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This file is based on code from bdf.c,v 1.22 2000/03/16 20:08:50 |
||||
* |
||||
* taken from Mark Leisher's xmbdfed package |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTHASH_H_ |
||||
#define FTHASH_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
typedef union FT_Hashkey_ |
||||
{ |
||||
FT_Int num; |
||||
const char* str; |
||||
|
||||
} FT_Hashkey; |
||||
|
||||
|
||||
typedef struct FT_HashnodeRec_ |
||||
{ |
||||
FT_Hashkey key; |
||||
size_t data; |
||||
|
||||
} FT_HashnodeRec; |
||||
|
||||
typedef struct FT_HashnodeRec_ *FT_Hashnode; |
||||
|
||||
|
||||
typedef FT_ULong |
||||
(*FT_Hash_LookupFunc)( FT_Hashkey* key ); |
||||
|
||||
typedef FT_Bool |
||||
(*FT_Hash_CompareFunc)( FT_Hashkey* a, |
||||
FT_Hashkey* b ); |
||||
|
||||
|
||||
typedef struct FT_HashRec_ |
||||
{ |
||||
FT_UInt limit; |
||||
FT_UInt size; |
||||
FT_UInt used; |
||||
|
||||
FT_Hash_LookupFunc lookup; |
||||
FT_Hash_CompareFunc compare; |
||||
|
||||
FT_Hashnode* table; |
||||
|
||||
} FT_HashRec; |
||||
|
||||
typedef struct FT_HashRec_ *FT_Hash; |
||||
|
||||
|
||||
FT_Error |
||||
ft_hash_str_init( FT_Hash hash, |
||||
FT_Memory memory ); |
||||
|
||||
FT_Error |
||||
ft_hash_num_init( FT_Hash hash, |
||||
FT_Memory memory ); |
||||
|
||||
void |
||||
ft_hash_str_free( FT_Hash hash, |
||||
FT_Memory memory ); |
||||
|
||||
#define ft_hash_num_free ft_hash_str_free |
||||
|
||||
FT_Error |
||||
ft_hash_str_insert( const char* key, |
||||
size_t data, |
||||
FT_Hash hash, |
||||
FT_Memory memory ); |
||||
|
||||
FT_Error |
||||
ft_hash_num_insert( FT_Int num, |
||||
size_t data, |
||||
FT_Hash hash, |
||||
FT_Memory memory ); |
||||
|
||||
size_t* |
||||
ft_hash_str_lookup( const char* key, |
||||
FT_Hash hash ); |
||||
|
||||
size_t* |
||||
ft_hash_num_lookup( FT_Int num, |
||||
FT_Hash hash ); |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FTHASH_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,398 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmemory.h |
||||
* |
||||
* The FreeType memory management macros (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMEMORY_H_ |
||||
#define FTMEMORY_H_ |
||||
|
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_CONFIG_H |
||||
#include <freetype/fttypes.h> |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_SET_ERROR |
||||
* |
||||
* @description: |
||||
* This macro is used to set an implicit 'error' variable to a given |
||||
* expression's value (usually a function call), and convert it to a |
||||
* boolean which is set whenever the value is != 0. |
||||
*/ |
||||
#undef FT_SET_ERROR |
||||
#define FT_SET_ERROR( expression ) \ |
||||
( ( error = (expression) ) != 0 ) |
||||
|
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/**** ****/ |
||||
/**** ****/ |
||||
/**** M E M O R Y ****/ |
||||
/**** ****/ |
||||
/**** ****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
|
||||
/* The calculation `NULL + n' is undefined in C. Even if the resulting */ |
||||
/* pointer doesn't get dereferenced, this causes warnings with */ |
||||
/* sanitizers. */ |
||||
/* */ |
||||
/* We thus provide a macro that should be used if `base' can be NULL. */ |
||||
#define FT_OFFSET( base, count ) ( (base) ? (base) + (count) : NULL ) |
||||
|
||||
|
||||
/*
|
||||
* C++ refuses to handle statements like p = (void*)anything, with `p' a |
||||
* typed pointer. Since we don't have a `typeof' operator in standard C++, |
||||
* we have to use a template to emulate it. |
||||
*/ |
||||
|
||||
#ifdef __cplusplus |
||||
|
||||
extern "C++" |
||||
{ |
||||
template <typename T> inline T* |
||||
cplusplus_typeof( T*, |
||||
void *v ) |
||||
{ |
||||
return static_cast <T*> ( v ); |
||||
} |
||||
} |
||||
|
||||
#define FT_ASSIGNP( p, val ) (p) = cplusplus_typeof( (p), (val) ) |
||||
|
||||
#else |
||||
|
||||
#define FT_ASSIGNP( p, val ) (p) = (val) |
||||
|
||||
#endif |
||||
|
||||
|
||||
|
||||
#ifdef FT_DEBUG_MEMORY |
||||
|
||||
FT_BASE( const char* ) ft_debug_file_; |
||||
FT_BASE( long ) ft_debug_lineno_; |
||||
|
||||
#define FT_DEBUG_INNER( exp ) ( ft_debug_file_ = __FILE__, \ |
||||
ft_debug_lineno_ = __LINE__, \
|
||||
(exp) ) |
||||
|
||||
#define FT_ASSIGNP_INNER( p, exp ) ( ft_debug_file_ = __FILE__, \ |
||||
ft_debug_lineno_ = __LINE__, \
|
||||
FT_ASSIGNP( p, exp ) ) |
||||
|
||||
#else /* !FT_DEBUG_MEMORY */ |
||||
|
||||
#define FT_DEBUG_INNER( exp ) (exp) |
||||
#define FT_ASSIGNP_INNER( p, exp ) FT_ASSIGNP( p, exp ) |
||||
|
||||
#endif /* !FT_DEBUG_MEMORY */ |
||||
|
||||
|
||||
/*
|
||||
* The allocation functions return a pointer, and the error code is written |
||||
* to through the `p_error' parameter. |
||||
*/ |
||||
|
||||
/* The `q' variants of the functions below (`q' for `quick') don't fill */ |
||||
/* the allocated or reallocated memory with zero bytes. */ |
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_alloc( FT_Memory memory, |
||||
FT_Long size, |
||||
FT_Error *p_error ); |
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_qalloc( FT_Memory memory, |
||||
FT_Long size, |
||||
FT_Error *p_error ); |
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_realloc( FT_Memory memory, |
||||
FT_Long item_size, |
||||
FT_Long cur_count, |
||||
FT_Long new_count, |
||||
void* block, |
||||
FT_Error *p_error ); |
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_qrealloc( FT_Memory memory, |
||||
FT_Long item_size, |
||||
FT_Long cur_count, |
||||
FT_Long new_count, |
||||
void* block, |
||||
FT_Error *p_error ); |
||||
|
||||
FT_BASE( void ) |
||||
ft_mem_free( FT_Memory memory, |
||||
const void* P ); |
||||
|
||||
|
||||
/* The `Q' variants of the macros below (`Q' for `quick') don't fill */ |
||||
/* the allocated or reallocated memory with zero bytes. */ |
||||
|
||||
#define FT_MEM_ALLOC( ptr, size ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_alloc( memory, \
|
||||
(FT_Long)(size), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_FREE( ptr ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_DEBUG_INNER( ft_mem_free( memory, (ptr) ) ); \
|
||||
(ptr) = NULL; \
|
||||
FT_END_STMNT |
||||
|
||||
#define FT_MEM_NEW( ptr ) \ |
||||
FT_MEM_ALLOC( ptr, sizeof ( *(ptr) ) ) |
||||
|
||||
#define FT_MEM_REALLOC( ptr, cursz, newsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_realloc( memory, \
|
||||
1, \
|
||||
(FT_Long)(cursz), \
|
||||
(FT_Long)(newsz), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QALLOC( ptr, size ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qalloc( memory, \
|
||||
(FT_Long)(size), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QNEW( ptr ) \ |
||||
FT_MEM_QALLOC( ptr, sizeof ( *(ptr) ) ) |
||||
|
||||
#define FT_MEM_QREALLOC( ptr, cursz, newsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qrealloc( memory, \
|
||||
1, \
|
||||
(FT_Long)(cursz), \
|
||||
(FT_Long)(newsz), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_ALLOC_MULT( ptr, count, item_size ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_realloc( memory, \
|
||||
(FT_Long)(item_size), \
|
||||
0, \
|
||||
(FT_Long)(count), \
|
||||
NULL, \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_REALLOC_MULT( ptr, oldcnt, newcnt, itmsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_realloc( memory, \
|
||||
(FT_Long)(itmsz), \
|
||||
(FT_Long)(oldcnt), \
|
||||
(FT_Long)(newcnt), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QALLOC_MULT( ptr, count, item_size ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qrealloc( memory, \
|
||||
(FT_Long)(item_size), \
|
||||
0, \
|
||||
(FT_Long)(count), \
|
||||
NULL, \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QREALLOC_MULT( ptr, oldcnt, newcnt, itmsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qrealloc( memory, \
|
||||
(FT_Long)(itmsz), \
|
||||
(FT_Long)(oldcnt), \
|
||||
(FT_Long)(newcnt), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
|
||||
#define FT_MEM_SET_ERROR( cond ) ( (cond), error != 0 ) |
||||
|
||||
|
||||
#define FT_MEM_SET( dest, byte, count ) \ |
||||
ft_memset( dest, byte, (FT_Offset)(count) ) |
||||
|
||||
#define FT_MEM_COPY( dest, source, count ) \ |
||||
ft_memcpy( dest, source, (FT_Offset)(count) ) |
||||
|
||||
#define FT_MEM_MOVE( dest, source, count ) \ |
||||
ft_memmove( dest, source, (FT_Offset)(count) ) |
||||
|
||||
|
||||
#define FT_MEM_ZERO( dest, count ) FT_MEM_SET( dest, 0, count ) |
||||
|
||||
#define FT_ZERO( p ) FT_MEM_ZERO( p, sizeof ( *(p) ) ) |
||||
|
||||
|
||||
#define FT_ARRAY_ZERO( dest, count ) \ |
||||
FT_MEM_ZERO( dest, \
|
||||
(FT_Offset)(count) * sizeof ( *(dest) ) ) |
||||
|
||||
#define FT_ARRAY_COPY( dest, source, count ) \ |
||||
FT_MEM_COPY( dest, \
|
||||
source, \
|
||||
(FT_Offset)(count) * sizeof ( *(dest) ) ) |
||||
|
||||
#define FT_ARRAY_MOVE( dest, source, count ) \ |
||||
FT_MEM_MOVE( dest, \
|
||||
source, \
|
||||
(FT_Offset)(count) * sizeof ( *(dest) ) ) |
||||
|
||||
|
||||
/*
|
||||
* Return the maximum number of addressable elements in an array. We limit |
||||
* ourselves to INT_MAX, rather than UINT_MAX, to avoid any problems. |
||||
*/ |
||||
#define FT_ARRAY_MAX( ptr ) ( FT_INT_MAX / sizeof ( *(ptr) ) ) |
||||
|
||||
#define FT_ARRAY_CHECK( ptr, count ) ( (count) <= FT_ARRAY_MAX( ptr ) ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* The following functions macros expect that their pointer argument is |
||||
* _typed_ in order to automatically compute array element sizes. |
||||
*/ |
||||
|
||||
#define FT_MEM_NEW_ARRAY( ptr, count ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_realloc( memory, \
|
||||
sizeof ( *(ptr) ), \
|
||||
0, \
|
||||
(FT_Long)(count), \
|
||||
NULL, \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_RENEW_ARRAY( ptr, cursz, newsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_realloc( memory, \
|
||||
sizeof ( *(ptr) ), \
|
||||
(FT_Long)(cursz), \
|
||||
(FT_Long)(newsz), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QNEW_ARRAY( ptr, count ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qrealloc( memory, \
|
||||
sizeof ( *(ptr) ), \
|
||||
0, \
|
||||
(FT_Long)(count), \
|
||||
NULL, \
|
||||
&error ) ) |
||||
|
||||
#define FT_MEM_QRENEW_ARRAY( ptr, cursz, newsz ) \ |
||||
FT_ASSIGNP_INNER( ptr, ft_mem_qrealloc( memory, \
|
||||
sizeof ( *(ptr) ), \
|
||||
(FT_Long)(cursz), \
|
||||
(FT_Long)(newsz), \
|
||||
(ptr), \
|
||||
&error ) ) |
||||
|
||||
#define FT_ALLOC( ptr, size ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_ALLOC( ptr, size ) ) |
||||
|
||||
#define FT_REALLOC( ptr, cursz, newsz ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_REALLOC( ptr, cursz, newsz ) ) |
||||
|
||||
#define FT_ALLOC_MULT( ptr, count, item_size ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_ALLOC_MULT( ptr, count, item_size ) ) |
||||
|
||||
#define FT_REALLOC_MULT( ptr, oldcnt, newcnt, itmsz ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_REALLOC_MULT( ptr, oldcnt, \
|
||||
newcnt, itmsz ) ) |
||||
|
||||
#define FT_QALLOC( ptr, size ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QALLOC( ptr, size ) ) |
||||
|
||||
#define FT_QREALLOC( ptr, cursz, newsz ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QREALLOC( ptr, cursz, newsz ) ) |
||||
|
||||
#define FT_QALLOC_MULT( ptr, count, item_size ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QALLOC_MULT( ptr, count, item_size ) ) |
||||
|
||||
#define FT_QREALLOC_MULT( ptr, oldcnt, newcnt, itmsz ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QREALLOC_MULT( ptr, oldcnt, \
|
||||
newcnt, itmsz ) ) |
||||
|
||||
#define FT_FREE( ptr ) FT_MEM_FREE( ptr ) |
||||
|
||||
#define FT_NEW( ptr ) FT_MEM_SET_ERROR( FT_MEM_NEW( ptr ) ) |
||||
|
||||
#define FT_NEW_ARRAY( ptr, count ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_NEW_ARRAY( ptr, count ) ) |
||||
|
||||
#define FT_RENEW_ARRAY( ptr, curcnt, newcnt ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_RENEW_ARRAY( ptr, curcnt, newcnt ) ) |
||||
|
||||
#define FT_QNEW( ptr ) FT_MEM_SET_ERROR( FT_MEM_QNEW( ptr ) ) |
||||
|
||||
#define FT_QNEW_ARRAY( ptr, count ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QNEW_ARRAY( ptr, count ) ) |
||||
|
||||
#define FT_QRENEW_ARRAY( ptr, curcnt, newcnt ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_QRENEW_ARRAY( ptr, curcnt, newcnt ) ) |
||||
|
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_strdup( FT_Memory memory, |
||||
const char* str, |
||||
FT_Error *p_error ); |
||||
|
||||
FT_BASE( FT_Pointer ) |
||||
ft_mem_dup( FT_Memory memory, |
||||
const void* address, |
||||
FT_ULong size, |
||||
FT_Error *p_error ); |
||||
|
||||
|
||||
#define FT_MEM_STRDUP( dst, str ) \ |
||||
(dst) = (char*)ft_mem_strdup( memory, (const char*)(str), &error ) |
||||
|
||||
#define FT_STRDUP( dst, str ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_STRDUP( dst, str ) ) |
||||
|
||||
#define FT_MEM_DUP( dst, address, size ) \ |
||||
(dst) = ft_mem_dup( memory, (address), (FT_ULong)(size), &error ) |
||||
|
||||
#define FT_DUP( dst, address, size ) \ |
||||
FT_MEM_SET_ERROR( FT_MEM_DUP( dst, address, size ) ) |
||||
|
||||
|
||||
/* Return >= 1 if a truncation occurs. */ |
||||
/* Return 0 if the source string fits the buffer. */ |
||||
/* This is *not* the same as strlcpy(). */ |
||||
FT_BASE( FT_Int ) |
||||
ft_mem_strcpyn( char* dst, |
||||
const char* src, |
||||
FT_ULong size ); |
||||
|
||||
#define FT_STRCPYN( dst, src, size ) \ |
||||
ft_mem_strcpyn( (char*)dst, (const char*)(src), (FT_ULong)(size) ) |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTMEMORY_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,91 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftmmtypes.h |
||||
* |
||||
* OpenType Variations type definitions for internal use |
||||
* with the multi-masters service (specification). |
||||
* |
||||
* Copyright (C) 2022-2023 by |
||||
* David Turner, Robert Wilhelm, Werner Lemberg, George Williams, and |
||||
* Dominik Röttsches. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTMMTYPES_H_ |
||||
#define FTMMTYPES_H_ |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
typedef FT_Int32 FT_ItemVarDelta; |
||||
|
||||
typedef struct GX_ItemVarDataRec_ |
||||
{ |
||||
FT_UInt itemCount; /* Number of delta sets per item. */ |
||||
FT_UInt regionIdxCount; /* Number of region indices. */ |
||||
FT_UInt* regionIndices; /* Array of `regionCount` indices; */ |
||||
/* these index `varRegionList`. */ |
||||
FT_Byte* deltaSet; /* Array of `itemCount` deltas; */ |
||||
/* use `innerIndex` for this array. */ |
||||
FT_UShort wordDeltaCount; /* Number of the first 32-bit ints */ |
||||
/* or 16-bit ints of `deltaSet` */ |
||||
/* depending on `longWords`. */ |
||||
FT_Bool longWords; /* If true, `deltaSet` is a 32-bit */ |
||||
/* array followed by a 16-bit */ |
||||
/* array, otherwise a 16-bit array */ |
||||
/* followed by an 8-bit array. */ |
||||
} GX_ItemVarDataRec, *GX_ItemVarData; |
||||
|
||||
|
||||
/* contribution of one axis to a region */ |
||||
typedef struct GX_AxisCoordsRec_ |
||||
{ |
||||
FT_Fixed startCoord; |
||||
FT_Fixed peakCoord; /* zero means no effect (factor = 1) */ |
||||
FT_Fixed endCoord; |
||||
|
||||
} GX_AxisCoordsRec, *GX_AxisCoords; |
||||
|
||||
|
||||
typedef struct GX_VarRegionRec_ |
||||
{ |
||||
GX_AxisCoords axisList; /* array of axisCount records */ |
||||
|
||||
} GX_VarRegionRec, *GX_VarRegion; |
||||
|
||||
|
||||
/* item variation store */ |
||||
typedef struct GX_ItemVarStoreRec_ |
||||
{ |
||||
FT_UInt dataCount; |
||||
GX_ItemVarData varData; /* array of dataCount records; */ |
||||
/* use `outerIndex' for this array */ |
||||
FT_UShort axisCount; |
||||
FT_UInt regionCount; /* total number of regions defined */ |
||||
GX_VarRegion varRegionList; |
||||
|
||||
} GX_ItemVarStoreRec, *GX_ItemVarStore; |
||||
|
||||
|
||||
typedef struct GX_DeltaSetIdxMapRec_ |
||||
{ |
||||
FT_ULong mapCount; |
||||
FT_UInt* outerIndex; /* indices to item var data */ |
||||
FT_UInt* innerIndex; /* indices to delta set */ |
||||
|
||||
} GX_DeltaSetIdxMapRec, *GX_DeltaSetIdxMap; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTMMTYPES_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,47 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftpsprop.h |
||||
* |
||||
* Get and set properties of PostScript drivers (specification). |
||||
* |
||||
* Copyright (C) 2017-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTPSPROP_H_ |
||||
#define FTPSPROP_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
FT_BASE_CALLBACK( FT_Error ) |
||||
ps_property_set( FT_Module module, /* PS_Driver */ |
||||
const char* property_name, |
||||
const void* value, |
||||
FT_Bool value_is_string ); |
||||
|
||||
FT_BASE_CALLBACK( FT_Error ) |
||||
ps_property_get( FT_Module module, /* PS_Driver */ |
||||
const char* property_name, |
||||
void* value ); |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FTPSPROP_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,245 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftrfork.h |
||||
* |
||||
* Embedded resource forks accessor (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 by |
||||
* Masatake YAMATO and Redhat K.K. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
/****************************************************************************
|
||||
* Development of the code in this file is support of |
||||
* Information-technology Promotion Agency, Japan. |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTRFORK_H_ |
||||
#define FTRFORK_H_ |
||||
|
||||
|
||||
#include <freetype/internal/ftobjs.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/* Number of guessing rules supported in `FT_Raccess_Guess'. */ |
||||
/* Don't forget to increment the number if you add a new guessing rule. */ |
||||
#define FT_RACCESS_N_RULES 9 |
||||
|
||||
|
||||
/* A structure to describe a reference in a resource by its resource ID */ |
||||
/* and internal offset. The `POST' resource expects to be concatenated */ |
||||
/* by the order of resource IDs instead of its appearance in the file. */ |
||||
|
||||
typedef struct FT_RFork_Ref_ |
||||
{ |
||||
FT_Short res_id; |
||||
FT_Long offset; |
||||
|
||||
} FT_RFork_Ref; |
||||
|
||||
|
||||
#ifdef FT_CONFIG_OPTION_GUESSING_EMBEDDED_RFORK |
||||
typedef FT_Error |
||||
(*ft_raccess_guess_func)( FT_Library library, |
||||
FT_Stream stream, |
||||
char *base_file_name, |
||||
char **result_file_name, |
||||
FT_Long *result_offset ); |
||||
|
||||
typedef enum FT_RFork_Rule_ { |
||||
FT_RFork_Rule_invalid = -2, |
||||
FT_RFork_Rule_uknown, /* -1 */ |
||||
FT_RFork_Rule_apple_double, |
||||
FT_RFork_Rule_apple_single, |
||||
FT_RFork_Rule_darwin_ufs_export, |
||||
FT_RFork_Rule_darwin_newvfs, |
||||
FT_RFork_Rule_darwin_hfsplus, |
||||
FT_RFork_Rule_vfat, |
||||
FT_RFork_Rule_linux_cap, |
||||
FT_RFork_Rule_linux_double, |
||||
FT_RFork_Rule_linux_netatalk |
||||
} FT_RFork_Rule; |
||||
|
||||
/* For fast translation between rule index and rule type,
|
||||
* the macros FT_RFORK_xxx should be kept consistent with the |
||||
* raccess_guess_funcs table |
||||
*/ |
||||
typedef struct ft_raccess_guess_rec_ { |
||||
ft_raccess_guess_func func; |
||||
FT_RFork_Rule type; |
||||
} ft_raccess_guess_rec; |
||||
|
||||
|
||||
#define CONST_FT_RFORK_RULE_ARRAY_BEGIN( name, type ) \ |
||||
static const type name[] = { |
||||
#define CONST_FT_RFORK_RULE_ARRAY_ENTRY( func_suffix, type_suffix ) \ |
||||
{ raccess_guess_ ## func_suffix, \
|
||||
FT_RFork_Rule_ ## type_suffix }, |
||||
/* this array is a storage, thus a final `;' is needed */ |
||||
#define CONST_FT_RFORK_RULE_ARRAY_END }; |
||||
|
||||
#endif /* FT_CONFIG_OPTION_GUESSING_EMBEDDED_RFORK */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Raccess_Guess |
||||
* |
||||
* @description: |
||||
* Guess a file name and offset where the actual resource fork is stored. |
||||
* The macro FT_RACCESS_N_RULES holds the number of guessing rules; the |
||||
* guessed result for the Nth rule is represented as a triplet: a new |
||||
* file name (new_names[N]), a file offset (offsets[N]), and an error |
||||
* code (errors[N]). |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A FreeType library instance. |
||||
* |
||||
* stream :: |
||||
* A file stream containing the resource fork. |
||||
* |
||||
* base_name :: |
||||
* The (base) file name of the resource fork used for some guessing |
||||
* rules. |
||||
* |
||||
* @output: |
||||
* new_names :: |
||||
* An array of guessed file names in which the resource forks may |
||||
* exist. If 'new_names[N]' is `NULL`, the guessed file name is equal |
||||
* to `base_name`. |
||||
* |
||||
* offsets :: |
||||
* An array of guessed file offsets. 'offsets[N]' holds the file |
||||
* offset of the possible start of the resource fork in file |
||||
* 'new_names[N]'. |
||||
* |
||||
* errors :: |
||||
* An array of FreeType error codes. 'errors[N]' is the error code of |
||||
* Nth guessing rule function. If 'errors[N]' is not FT_Err_Ok, |
||||
* 'new_names[N]' and 'offsets[N]' are meaningless. |
||||
*/ |
||||
FT_BASE( void ) |
||||
FT_Raccess_Guess( FT_Library library, |
||||
FT_Stream stream, |
||||
char* base_name, |
||||
char** new_names, |
||||
FT_Long* offsets, |
||||
FT_Error* errors ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Raccess_Get_HeaderInfo |
||||
* |
||||
* @description: |
||||
* Get the information from the header of resource fork. The information |
||||
* includes the file offset where the resource map starts, and the file |
||||
* offset where the resource data starts. `FT_Raccess_Get_DataOffsets` |
||||
* requires these two data. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A FreeType library instance. |
||||
* |
||||
* stream :: |
||||
* A file stream containing the resource fork. |
||||
* |
||||
* rfork_offset :: |
||||
* The file offset where the resource fork starts. |
||||
* |
||||
* @output: |
||||
* map_offset :: |
||||
* The file offset where the resource map starts. |
||||
* |
||||
* rdata_pos :: |
||||
* The file offset where the resource data starts. |
||||
* |
||||
* @return: |
||||
* FreeType error code. FT_Err_Ok means success. |
||||
*/ |
||||
FT_BASE( FT_Error ) |
||||
FT_Raccess_Get_HeaderInfo( FT_Library library, |
||||
FT_Stream stream, |
||||
FT_Long rfork_offset, |
||||
FT_Long *map_offset, |
||||
FT_Long *rdata_pos ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @function: |
||||
* FT_Raccess_Get_DataOffsets |
||||
* |
||||
* @description: |
||||
* Get the data offsets for a tag in a resource fork. Offsets are stored |
||||
* in an array because, in some cases, resources in a resource fork have |
||||
* the same tag. |
||||
* |
||||
* @input: |
||||
* library :: |
||||
* A FreeType library instance. |
||||
* |
||||
* stream :: |
||||
* A file stream containing the resource fork. |
||||
* |
||||
* map_offset :: |
||||
* The file offset where the resource map starts. |
||||
* |
||||
* rdata_pos :: |
||||
* The file offset where the resource data starts. |
||||
* |
||||
* tag :: |
||||
* The resource tag. |
||||
* |
||||
* sort_by_res_id :: |
||||
* A Boolean to sort the fragmented resource by their ids. The |
||||
* fragmented resources for 'POST' resource should be sorted to restore |
||||
* Type1 font properly. For 'sfnt' resources, sorting may induce a |
||||
* different order of the faces in comparison to that by QuickDraw API. |
||||
* |
||||
* @output: |
||||
* offsets :: |
||||
* The stream offsets for the resource data specified by 'tag'. This |
||||
* array is allocated by the function, so you have to call @ft_mem_free |
||||
* after use. |
||||
* |
||||
* count :: |
||||
* The length of offsets array. |
||||
* |
||||
* @return: |
||||
* FreeType error code. FT_Err_Ok means success. |
||||
* |
||||
* @note: |
||||
* Normally you should use `FT_Raccess_Get_HeaderInfo` to get the value |
||||
* for `map_offset` and `rdata_pos`. |
||||
*/ |
||||
FT_BASE( FT_Error ) |
||||
FT_Raccess_Get_DataOffsets( FT_Library library, |
||||
FT_Stream stream, |
||||
FT_Long map_offset, |
||||
FT_Long rdata_pos, |
||||
FT_Long tag, |
||||
FT_Bool sort_by_res_id, |
||||
FT_Long **offsets, |
||||
FT_Long *count ); |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTRFORK_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,495 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftserv.h |
||||
* |
||||
* The FreeType services (specification only). |
||||
* |
||||
* Copyright (C) 2003-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Each module can export one or more 'services'. Each service is |
||||
* identified by a constant string and modeled by a pointer; the latter |
||||
* generally corresponds to a structure containing function pointers. |
||||
* |
||||
* Note that a service's data cannot be a mere function pointer because in |
||||
* C it is possible that function pointers might be implemented differently |
||||
* than data pointers (e.g. 48 bits instead of 32). |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSERV_H_ |
||||
#define FTSERV_H_ |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FACE_FIND_SERVICE |
||||
* |
||||
* @description: |
||||
* This macro is used to look up a service from a face's driver module. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source face handle. |
||||
* |
||||
* id :: |
||||
* A string describing the service as defined in the service's header |
||||
* files (e.g. FT_SERVICE_ID_MULTI_MASTERS which expands to |
||||
* 'multi-masters'). It is automatically prefixed with |
||||
* `FT_SERVICE_ID_`. |
||||
* |
||||
* @output: |
||||
* ptr :: |
||||
* A variable that receives the service pointer. Will be `NULL` if not |
||||
* found. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
|
||||
#define FT_FACE_FIND_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Module module = FT_MODULE( FT_FACE( face )->driver ); \
|
||||
FT_Pointer _tmp_ = NULL; \
|
||||
FT_Pointer* _pptr_ = (FT_Pointer*)&(ptr); \
|
||||
\
|
||||
\
|
||||
if ( module->clazz->get_interface ) \
|
||||
_tmp_ = module->clazz->get_interface( module, FT_SERVICE_ID_ ## id ); \
|
||||
*_pptr_ = _tmp_; \
|
||||
FT_END_STMNT |
||||
|
||||
#else /* !C++ */ |
||||
|
||||
#define FT_FACE_FIND_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Module module = FT_MODULE( FT_FACE( face )->driver ); \
|
||||
FT_Pointer _tmp_ = NULL; \
|
||||
\
|
||||
if ( module->clazz->get_interface ) \
|
||||
_tmp_ = module->clazz->get_interface( module, FT_SERVICE_ID_ ## id ); \
|
||||
ptr = _tmp_; \
|
||||
FT_END_STMNT |
||||
|
||||
#endif /* !C++ */ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FACE_FIND_GLOBAL_SERVICE |
||||
* |
||||
* @description: |
||||
* This macro is used to look up a service from all modules. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source face handle. |
||||
* |
||||
* id :: |
||||
* A string describing the service as defined in the service's header |
||||
* files (e.g. FT_SERVICE_ID_MULTI_MASTERS which expands to |
||||
* 'multi-masters'). It is automatically prefixed with |
||||
* `FT_SERVICE_ID_`. |
||||
* |
||||
* @output: |
||||
* ptr :: |
||||
* A variable that receives the service pointer. Will be `NULL` if not |
||||
* found. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
|
||||
#define FT_FACE_FIND_GLOBAL_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Module module = FT_MODULE( FT_FACE( face )->driver ); \
|
||||
FT_Pointer _tmp_; \
|
||||
FT_Pointer* _pptr_ = (FT_Pointer*)&(ptr); \
|
||||
\
|
||||
\
|
||||
_tmp_ = ft_module_get_service( module, FT_SERVICE_ID_ ## id, 1 ); \
|
||||
*_pptr_ = _tmp_; \
|
||||
FT_END_STMNT |
||||
|
||||
#else /* !C++ */ |
||||
|
||||
#define FT_FACE_FIND_GLOBAL_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Module module = FT_MODULE( FT_FACE( face )->driver ); \
|
||||
FT_Pointer _tmp_; \
|
||||
\
|
||||
\
|
||||
_tmp_ = ft_module_get_service( module, FT_SERVICE_ID_ ## id, 1 ); \
|
||||
ptr = _tmp_; \
|
||||
FT_END_STMNT |
||||
|
||||
#endif /* !C++ */ |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/***** *****/ |
||||
/***** S E R V I C E D E S C R I P T O R S *****/ |
||||
/***** *****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
/*
|
||||
* The following structure is used to _describe_ a given service to the |
||||
* library. This is useful to build simple static service lists. |
||||
*/ |
||||
typedef struct FT_ServiceDescRec_ |
||||
{ |
||||
const char* serv_id; /* service name */ |
||||
const void* serv_data; /* service pointer/data */ |
||||
|
||||
} FT_ServiceDescRec; |
||||
|
||||
typedef const FT_ServiceDescRec* FT_ServiceDesc; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_DEFINE_SERVICEDESCREC1 |
||||
* FT_DEFINE_SERVICEDESCREC2 |
||||
* FT_DEFINE_SERVICEDESCREC3 |
||||
* FT_DEFINE_SERVICEDESCREC4 |
||||
* FT_DEFINE_SERVICEDESCREC5 |
||||
* FT_DEFINE_SERVICEDESCREC6 |
||||
* FT_DEFINE_SERVICEDESCREC7 |
||||
* FT_DEFINE_SERVICEDESCREC8 |
||||
* FT_DEFINE_SERVICEDESCREC9 |
||||
* FT_DEFINE_SERVICEDESCREC10 |
||||
* |
||||
* @description: |
||||
* Used to initialize an array of FT_ServiceDescRec structures. |
||||
* |
||||
* The array will be allocated in the global scope (or the scope where |
||||
* the macro is used). |
||||
*/ |
||||
#define FT_DEFINE_SERVICEDESCREC1( class_, \ |
||||
serv_id_1, serv_data_1 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC2( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC3( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC4( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC5( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC6( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5, \
|
||||
serv_id_6, serv_data_6 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ serv_id_6, serv_data_6 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC7( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5, \
|
||||
serv_id_6, serv_data_6, \
|
||||
serv_id_7, serv_data_7 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ serv_id_6, serv_data_6 }, \
|
||||
{ serv_id_7, serv_data_7 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC8( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5, \
|
||||
serv_id_6, serv_data_6, \
|
||||
serv_id_7, serv_data_7, \
|
||||
serv_id_8, serv_data_8 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ serv_id_6, serv_data_6 }, \
|
||||
{ serv_id_7, serv_data_7 }, \
|
||||
{ serv_id_8, serv_data_8 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC9( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5, \
|
||||
serv_id_6, serv_data_6, \
|
||||
serv_id_7, serv_data_7, \
|
||||
serv_id_8, serv_data_8, \
|
||||
serv_id_9, serv_data_9 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ serv_id_6, serv_data_6 }, \
|
||||
{ serv_id_7, serv_data_7 }, \
|
||||
{ serv_id_8, serv_data_8 }, \
|
||||
{ serv_id_9, serv_data_9 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
#define FT_DEFINE_SERVICEDESCREC10( class_, \ |
||||
serv_id_1, serv_data_1, \
|
||||
serv_id_2, serv_data_2, \
|
||||
serv_id_3, serv_data_3, \
|
||||
serv_id_4, serv_data_4, \
|
||||
serv_id_5, serv_data_5, \
|
||||
serv_id_6, serv_data_6, \
|
||||
serv_id_7, serv_data_7, \
|
||||
serv_id_8, serv_data_8, \
|
||||
serv_id_9, serv_data_9, \
|
||||
serv_id_10, serv_data_10 ) \
|
||||
static const FT_ServiceDescRec class_[] = \
|
||||
{ \
|
||||
{ serv_id_1, serv_data_1 }, \
|
||||
{ serv_id_2, serv_data_2 }, \
|
||||
{ serv_id_3, serv_data_3 }, \
|
||||
{ serv_id_4, serv_data_4 }, \
|
||||
{ serv_id_5, serv_data_5 }, \
|
||||
{ serv_id_6, serv_data_6 }, \
|
||||
{ serv_id_7, serv_data_7 }, \
|
||||
{ serv_id_8, serv_data_8 }, \
|
||||
{ serv_id_9, serv_data_9 }, \
|
||||
{ serv_id_10, serv_data_10 }, \
|
||||
{ NULL, NULL } \
|
||||
}; |
||||
|
||||
|
||||
/*
|
||||
* Parse a list of FT_ServiceDescRec descriptors and look for a specific |
||||
* service by ID. Note that the last element in the array must be { NULL, |
||||
* NULL }, and that the function should return NULL if the service isn't |
||||
* available. |
||||
* |
||||
* This function can be used by modules to implement their `get_service' |
||||
* method. |
||||
*/ |
||||
FT_BASE( FT_Pointer ) |
||||
ft_service_list_lookup( FT_ServiceDesc service_descriptors, |
||||
const char* service_id ); |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/***** *****/ |
||||
/***** S E R V I C E S C A C H E *****/ |
||||
/***** *****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
/*
|
||||
* This structure is used to store a cache for several frequently used |
||||
* services. It is the type of `face->internal->services'. You should |
||||
* only use FT_FACE_LOOKUP_SERVICE to access it. |
||||
* |
||||
* All fields should have the type FT_Pointer to relax compilation |
||||
* dependencies. We assume the developer isn't completely stupid. |
||||
* |
||||
* Each field must be named `service_XXXX' where `XXX' corresponds to the |
||||
* correct FT_SERVICE_ID_XXXX macro. See the definition of |
||||
* FT_FACE_LOOKUP_SERVICE below how this is implemented. |
||||
* |
||||
*/ |
||||
typedef struct FT_ServiceCacheRec_ |
||||
{ |
||||
FT_Pointer service_POSTSCRIPT_FONT_NAME; |
||||
FT_Pointer service_MULTI_MASTERS; |
||||
FT_Pointer service_METRICS_VARIATIONS; |
||||
FT_Pointer service_GLYPH_DICT; |
||||
FT_Pointer service_PFR_METRICS; |
||||
FT_Pointer service_WINFNT; |
||||
|
||||
} FT_ServiceCacheRec, *FT_ServiceCache; |
||||
|
||||
|
||||
/*
|
||||
* A magic number used within the services cache. |
||||
*/ |
||||
|
||||
/* ensure that value `1' has the same width as a pointer */ |
||||
#define FT_SERVICE_UNAVAILABLE ((FT_Pointer)~(FT_PtrDist)1) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @macro: |
||||
* FT_FACE_LOOKUP_SERVICE |
||||
* |
||||
* @description: |
||||
* This macro is used to look up a service from a face's driver module |
||||
* using its cache. |
||||
* |
||||
* @input: |
||||
* face :: |
||||
* The source face handle containing the cache. |
||||
* |
||||
* field :: |
||||
* The field name in the cache. |
||||
* |
||||
* id :: |
||||
* The service ID. |
||||
* |
||||
* @output: |
||||
* ptr :: |
||||
* A variable receiving the service data. `NULL` if not available. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
|
||||
#define FT_FACE_LOOKUP_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Pointer svc; \
|
||||
FT_Pointer* Pptr = (FT_Pointer*)&(ptr); \
|
||||
\
|
||||
\
|
||||
svc = FT_FACE( face )->internal->services. service_ ## id; \
|
||||
if ( svc == FT_SERVICE_UNAVAILABLE ) \
|
||||
svc = NULL; \
|
||||
else if ( svc == NULL ) \
|
||||
{ \
|
||||
FT_FACE_FIND_SERVICE( face, svc, id ); \
|
||||
\
|
||||
FT_FACE( face )->internal->services. service_ ## id = \
|
||||
(FT_Pointer)( svc != NULL ? svc \
|
||||
: FT_SERVICE_UNAVAILABLE ); \
|
||||
} \
|
||||
*Pptr = svc; \
|
||||
FT_END_STMNT |
||||
|
||||
#else /* !C++ */ |
||||
|
||||
#define FT_FACE_LOOKUP_SERVICE( face, ptr, id ) \ |
||||
FT_BEGIN_STMNT \
|
||||
FT_Pointer svc; \
|
||||
\
|
||||
\
|
||||
svc = FT_FACE( face )->internal->services. service_ ## id; \
|
||||
if ( svc == FT_SERVICE_UNAVAILABLE ) \
|
||||
svc = NULL; \
|
||||
else if ( svc == NULL ) \
|
||||
{ \
|
||||
FT_FACE_FIND_SERVICE( face, svc, id ); \
|
||||
\
|
||||
FT_FACE( face )->internal->services. service_ ## id = \
|
||||
(FT_Pointer)( svc != NULL ? svc \
|
||||
: FT_SERVICE_UNAVAILABLE ); \
|
||||
} \
|
||||
ptr = svc; \
|
||||
FT_END_STMNT |
||||
|
||||
#endif /* !C++ */ |
||||
|
||||
/*
|
||||
* A macro used to define new service structure types. |
||||
*/ |
||||
|
||||
#define FT_DEFINE_SERVICE( name ) \ |
||||
typedef struct FT_Service_ ## name ## Rec_ \
|
||||
FT_Service_ ## name ## Rec ; \
|
||||
typedef struct FT_Service_ ## name ## Rec_ \
|
||||
const * FT_Service_ ## name ; \
|
||||
struct FT_Service_ ## name ## Rec_ |
||||
|
||||
/* */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSERV_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,570 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftstream.h |
||||
* |
||||
* Stream handling (specification). |
||||
* |
||||
* Copyright (C) 1996-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTSTREAM_H_ |
||||
#define FTSTREAM_H_ |
||||
|
||||
|
||||
#include <ft2build.h> |
||||
#include <freetype/ftsystem.h> |
||||
#include <freetype/internal/ftobjs.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/* format of an 8-bit frame_op value: */ |
||||
/* */ |
||||
/* bit 76543210 */ |
||||
/* xxxxxxes */ |
||||
/* */ |
||||
/* s is set to 1 if the value is signed. */ |
||||
/* e is set to 1 if the value is little-endian. */ |
||||
/* xxx is a command. */ |
||||
|
||||
#define FT_FRAME_OP_SHIFT 2 |
||||
#define FT_FRAME_OP_SIGNED 1 |
||||
#define FT_FRAME_OP_LITTLE 2 |
||||
#define FT_FRAME_OP_COMMAND( x ) ( x >> FT_FRAME_OP_SHIFT ) |
||||
|
||||
#define FT_MAKE_FRAME_OP( command, little, sign ) \ |
||||
( ( command << FT_FRAME_OP_SHIFT ) | ( little << 1 ) | sign ) |
||||
|
||||
#define FT_FRAME_OP_END 0 |
||||
#define FT_FRAME_OP_START 1 /* start a new frame */ |
||||
#define FT_FRAME_OP_BYTE 2 /* read 1-byte value */ |
||||
#define FT_FRAME_OP_SHORT 3 /* read 2-byte value */ |
||||
#define FT_FRAME_OP_LONG 4 /* read 4-byte value */ |
||||
#define FT_FRAME_OP_OFF3 5 /* read 3-byte value */ |
||||
#define FT_FRAME_OP_BYTES 6 /* read a bytes sequence */ |
||||
|
||||
|
||||
typedef enum FT_Frame_Op_ |
||||
{ |
||||
ft_frame_end = 0, |
||||
ft_frame_start = FT_MAKE_FRAME_OP( FT_FRAME_OP_START, 0, 0 ), |
||||
|
||||
ft_frame_byte = FT_MAKE_FRAME_OP( FT_FRAME_OP_BYTE, 0, 0 ), |
||||
ft_frame_schar = FT_MAKE_FRAME_OP( FT_FRAME_OP_BYTE, 0, 1 ), |
||||
|
||||
ft_frame_ushort_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_SHORT, 0, 0 ), |
||||
ft_frame_short_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_SHORT, 0, 1 ), |
||||
ft_frame_ushort_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_SHORT, 1, 0 ), |
||||
ft_frame_short_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_SHORT, 1, 1 ), |
||||
|
||||
ft_frame_ulong_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_LONG, 0, 0 ), |
||||
ft_frame_long_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_LONG, 0, 1 ), |
||||
ft_frame_ulong_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_LONG, 1, 0 ), |
||||
ft_frame_long_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_LONG, 1, 1 ), |
||||
|
||||
ft_frame_uoff3_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_OFF3, 0, 0 ), |
||||
ft_frame_off3_be = FT_MAKE_FRAME_OP( FT_FRAME_OP_OFF3, 0, 1 ), |
||||
ft_frame_uoff3_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_OFF3, 1, 0 ), |
||||
ft_frame_off3_le = FT_MAKE_FRAME_OP( FT_FRAME_OP_OFF3, 1, 1 ), |
||||
|
||||
ft_frame_bytes = FT_MAKE_FRAME_OP( FT_FRAME_OP_BYTES, 0, 0 ), |
||||
ft_frame_skip = FT_MAKE_FRAME_OP( FT_FRAME_OP_BYTES, 0, 1 ) |
||||
|
||||
} FT_Frame_Op; |
||||
|
||||
|
||||
typedef struct FT_Frame_Field_ |
||||
{ |
||||
FT_Byte value; |
||||
FT_Byte size; |
||||
FT_UShort offset; |
||||
|
||||
} FT_Frame_Field; |
||||
|
||||
|
||||
/* Construct an FT_Frame_Field out of a structure type and a field name. */ |
||||
/* The structure type must be set in the FT_STRUCTURE macro before */ |
||||
/* calling the FT_FRAME_START() macro. */ |
||||
/* */ |
||||
#define FT_FIELD_SIZE( f ) \ |
||||
(FT_Byte)sizeof ( ((FT_STRUCTURE*)0)->f ) |
||||
|
||||
#define FT_FIELD_SIZE_DELTA( f ) \ |
||||
(FT_Byte)sizeof ( ((FT_STRUCTURE*)0)->f[0] ) |
||||
|
||||
#define FT_FIELD_OFFSET( f ) \ |
||||
(FT_UShort)( offsetof( FT_STRUCTURE, f ) ) |
||||
|
||||
#define FT_FRAME_FIELD( frame_op, field ) \ |
||||
{ \
|
||||
frame_op, \
|
||||
FT_FIELD_SIZE( field ), \
|
||||
FT_FIELD_OFFSET( field ) \
|
||||
} |
||||
|
||||
#define FT_MAKE_EMPTY_FIELD( frame_op ) { frame_op, 0, 0 } |
||||
|
||||
#define FT_FRAME_START( size ) { ft_frame_start, 0, size } |
||||
#define FT_FRAME_END { ft_frame_end, 0, 0 } |
||||
|
||||
#define FT_FRAME_LONG( f ) FT_FRAME_FIELD( ft_frame_long_be, f ) |
||||
#define FT_FRAME_ULONG( f ) FT_FRAME_FIELD( ft_frame_ulong_be, f ) |
||||
#define FT_FRAME_SHORT( f ) FT_FRAME_FIELD( ft_frame_short_be, f ) |
||||
#define FT_FRAME_USHORT( f ) FT_FRAME_FIELD( ft_frame_ushort_be, f ) |
||||
#define FT_FRAME_OFF3( f ) FT_FRAME_FIELD( ft_frame_off3_be, f ) |
||||
#define FT_FRAME_UOFF3( f ) FT_FRAME_FIELD( ft_frame_uoff3_be, f ) |
||||
#define FT_FRAME_BYTE( f ) FT_FRAME_FIELD( ft_frame_byte, f ) |
||||
#define FT_FRAME_CHAR( f ) FT_FRAME_FIELD( ft_frame_schar, f ) |
||||
|
||||
#define FT_FRAME_LONG_LE( f ) FT_FRAME_FIELD( ft_frame_long_le, f ) |
||||
#define FT_FRAME_ULONG_LE( f ) FT_FRAME_FIELD( ft_frame_ulong_le, f ) |
||||
#define FT_FRAME_SHORT_LE( f ) FT_FRAME_FIELD( ft_frame_short_le, f ) |
||||
#define FT_FRAME_USHORT_LE( f ) FT_FRAME_FIELD( ft_frame_ushort_le, f ) |
||||
#define FT_FRAME_OFF3_LE( f ) FT_FRAME_FIELD( ft_frame_off3_le, f ) |
||||
#define FT_FRAME_UOFF3_LE( f ) FT_FRAME_FIELD( ft_frame_uoff3_le, f ) |
||||
|
||||
#define FT_FRAME_SKIP_LONG { ft_frame_long_be, 0, 0 } |
||||
#define FT_FRAME_SKIP_SHORT { ft_frame_short_be, 0, 0 } |
||||
#define FT_FRAME_SKIP_BYTE { ft_frame_byte, 0, 0 } |
||||
|
||||
#define FT_FRAME_BYTES( field, count ) \ |
||||
{ \
|
||||
ft_frame_bytes, \
|
||||
count, \
|
||||
FT_FIELD_OFFSET( field ) \
|
||||
} |
||||
|
||||
#define FT_FRAME_SKIP_BYTES( count ) { ft_frame_skip, count, 0 } |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Integer extraction macros -- the 'buffer' parameter must ALWAYS be of |
||||
* type 'char*' or equivalent (1-byte elements). |
||||
*/ |
||||
|
||||
#define FT_BYTE_( p, i ) ( ((const FT_Byte*)(p))[(i)] ) |
||||
|
||||
#define FT_INT16( x ) ( (FT_Int16)(x) ) |
||||
#define FT_UINT16( x ) ( (FT_UInt16)(x) ) |
||||
#define FT_INT32( x ) ( (FT_Int32)(x) ) |
||||
#define FT_UINT32( x ) ( (FT_UInt32)(x) ) |
||||
|
||||
|
||||
#define FT_BYTE_U16( p, i, s ) ( FT_UINT16( FT_BYTE_( p, i ) ) << (s) ) |
||||
#define FT_BYTE_U32( p, i, s ) ( FT_UINT32( FT_BYTE_( p, i ) ) << (s) ) |
||||
|
||||
|
||||
/*
|
||||
* function acts on increases does range for emits |
||||
* pointer checking frames error |
||||
* ------------------------------------------------------------------- |
||||
* FT_PEEK_XXX buffer pointer no no no no |
||||
* FT_NEXT_XXX buffer pointer yes no no no |
||||
* FT_GET_XXX stream->cursor yes yes yes no |
||||
* FT_READ_XXX stream->pos yes yes no yes |
||||
*/ |
||||
|
||||
|
||||
/*
|
||||
* `FT_PEEK_XXX' are generic macros to get data from a buffer position. No |
||||
* safety checks are performed. |
||||
*/ |
||||
#define FT_PEEK_SHORT( p ) FT_INT16( FT_BYTE_U16( p, 0, 8 ) | \ |
||||
FT_BYTE_U16( p, 1, 0 ) ) |
||||
|
||||
#define FT_PEEK_USHORT( p ) FT_UINT16( FT_BYTE_U16( p, 0, 8 ) | \ |
||||
FT_BYTE_U16( p, 1, 0 ) ) |
||||
|
||||
#define FT_PEEK_LONG( p ) FT_INT32( FT_BYTE_U32( p, 0, 24 ) | \ |
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 2, 8 ) | \
|
||||
FT_BYTE_U32( p, 3, 0 ) ) |
||||
|
||||
#define FT_PEEK_ULONG( p ) FT_UINT32( FT_BYTE_U32( p, 0, 24 ) | \ |
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 2, 8 ) | \
|
||||
FT_BYTE_U32( p, 3, 0 ) ) |
||||
|
||||
#define FT_PEEK_OFF3( p ) ( FT_INT32( FT_BYTE_U32( p, 0, 24 ) | \ |
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 2, 8 ) ) >> 8 ) |
||||
|
||||
#define FT_PEEK_UOFF3( p ) FT_UINT32( FT_BYTE_U32( p, 0, 16 ) | \ |
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 2, 0 ) ) |
||||
|
||||
#define FT_PEEK_SHORT_LE( p ) FT_INT16( FT_BYTE_U16( p, 1, 8 ) | \ |
||||
FT_BYTE_U16( p, 0, 0 ) ) |
||||
|
||||
#define FT_PEEK_USHORT_LE( p ) FT_UINT16( FT_BYTE_U16( p, 1, 8 ) | \ |
||||
FT_BYTE_U16( p, 0, 0 ) ) |
||||
|
||||
#define FT_PEEK_LONG_LE( p ) FT_INT32( FT_BYTE_U32( p, 3, 24 ) | \ |
||||
FT_BYTE_U32( p, 2, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 0, 0 ) ) |
||||
|
||||
#define FT_PEEK_ULONG_LE( p ) FT_UINT32( FT_BYTE_U32( p, 3, 24 ) | \ |
||||
FT_BYTE_U32( p, 2, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 0, 0 ) ) |
||||
|
||||
#define FT_PEEK_OFF3_LE( p ) ( FT_INT32( FT_BYTE_U32( p, 2, 24 ) | \ |
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 0, 8 ) ) >> 8 ) |
||||
|
||||
#define FT_PEEK_UOFF3_LE( p ) FT_UINT32( FT_BYTE_U32( p, 2, 16 ) | \ |
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 0, 0 ) ) |
||||
|
||||
/*
|
||||
* `FT_NEXT_XXX' are generic macros to get data from a buffer position |
||||
* which is then increased appropriately. No safety checks are performed. |
||||
*/ |
||||
#define FT_NEXT_CHAR( buffer ) \ |
||||
( (signed char)*buffer++ ) |
||||
|
||||
#define FT_NEXT_BYTE( buffer ) \ |
||||
( (unsigned char)*buffer++ ) |
||||
|
||||
#define FT_NEXT_SHORT( buffer ) \ |
||||
( buffer += 2, FT_PEEK_SHORT( buffer - 2 ) ) |
||||
|
||||
#define FT_NEXT_USHORT( buffer ) \ |
||||
( buffer += 2, FT_PEEK_USHORT( buffer - 2 ) ) |
||||
|
||||
#define FT_NEXT_OFF3( buffer ) \ |
||||
( buffer += 3, FT_PEEK_OFF3( buffer - 3 ) ) |
||||
|
||||
#define FT_NEXT_UOFF3( buffer ) \ |
||||
( buffer += 3, FT_PEEK_UOFF3( buffer - 3 ) ) |
||||
|
||||
#define FT_NEXT_LONG( buffer ) \ |
||||
( buffer += 4, FT_PEEK_LONG( buffer - 4 ) ) |
||||
|
||||
#define FT_NEXT_ULONG( buffer ) \ |
||||
( buffer += 4, FT_PEEK_ULONG( buffer - 4 ) ) |
||||
|
||||
|
||||
#define FT_NEXT_SHORT_LE( buffer ) \ |
||||
( buffer += 2, FT_PEEK_SHORT_LE( buffer - 2 ) ) |
||||
|
||||
#define FT_NEXT_USHORT_LE( buffer ) \ |
||||
( buffer += 2, FT_PEEK_USHORT_LE( buffer - 2 ) ) |
||||
|
||||
#define FT_NEXT_OFF3_LE( buffer ) \ |
||||
( buffer += 3, FT_PEEK_OFF3_LE( buffer - 3 ) ) |
||||
|
||||
#define FT_NEXT_UOFF3_LE( buffer ) \ |
||||
( buffer += 3, FT_PEEK_UOFF3_LE( buffer - 3 ) ) |
||||
|
||||
#define FT_NEXT_LONG_LE( buffer ) \ |
||||
( buffer += 4, FT_PEEK_LONG_LE( buffer - 4 ) ) |
||||
|
||||
#define FT_NEXT_ULONG_LE( buffer ) \ |
||||
( buffer += 4, FT_PEEK_ULONG_LE( buffer - 4 ) ) |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* The `FT_GET_XXX` macros use an implicit 'stream' variable. |
||||
* |
||||
* Note that a call to `FT_STREAM_SEEK` or `FT_STREAM_POS` has **no** |
||||
* effect on `FT_GET_XXX`! They operate on `stream->pos`, while |
||||
* `FT_GET_XXX` use `stream->cursor`. |
||||
*/ |
||||
#if 0 |
||||
#define FT_GET_MACRO( type ) FT_NEXT_ ## type ( stream->cursor ) |
||||
|
||||
#define FT_GET_CHAR() FT_GET_MACRO( CHAR ) |
||||
#define FT_GET_BYTE() FT_GET_MACRO( BYTE ) |
||||
#define FT_GET_SHORT() FT_GET_MACRO( SHORT ) |
||||
#define FT_GET_USHORT() FT_GET_MACRO( USHORT ) |
||||
#define FT_GET_OFF3() FT_GET_MACRO( OFF3 ) |
||||
#define FT_GET_UOFF3() FT_GET_MACRO( UOFF3 ) |
||||
#define FT_GET_LONG() FT_GET_MACRO( LONG ) |
||||
#define FT_GET_ULONG() FT_GET_MACRO( ULONG ) |
||||
#define FT_GET_TAG4() FT_GET_MACRO( ULONG ) |
||||
|
||||
#define FT_GET_SHORT_LE() FT_GET_MACRO( SHORT_LE ) |
||||
#define FT_GET_USHORT_LE() FT_GET_MACRO( USHORT_LE ) |
||||
#define FT_GET_LONG_LE() FT_GET_MACRO( LONG_LE ) |
||||
#define FT_GET_ULONG_LE() FT_GET_MACRO( ULONG_LE ) |
||||
|
||||
#else |
||||
#define FT_GET_MACRO( func, type ) ( (type)func( stream ) ) |
||||
|
||||
#define FT_GET_CHAR() FT_GET_MACRO( FT_Stream_GetByte, FT_Char ) |
||||
#define FT_GET_BYTE() FT_GET_MACRO( FT_Stream_GetByte, FT_Byte ) |
||||
#define FT_GET_SHORT() FT_GET_MACRO( FT_Stream_GetUShort, FT_Int16 ) |
||||
#define FT_GET_USHORT() FT_GET_MACRO( FT_Stream_GetUShort, FT_UInt16 ) |
||||
#define FT_GET_UOFF3() FT_GET_MACRO( FT_Stream_GetUOffset, FT_UInt32 ) |
||||
#define FT_GET_LONG() FT_GET_MACRO( FT_Stream_GetULong, FT_Int32 ) |
||||
#define FT_GET_ULONG() FT_GET_MACRO( FT_Stream_GetULong, FT_UInt32 ) |
||||
#define FT_GET_TAG4() FT_GET_MACRO( FT_Stream_GetULong, FT_UInt32 ) |
||||
|
||||
#define FT_GET_SHORT_LE() FT_GET_MACRO( FT_Stream_GetUShortLE, FT_Int16 ) |
||||
#define FT_GET_USHORT_LE() FT_GET_MACRO( FT_Stream_GetUShortLE, FT_UInt16 ) |
||||
#define FT_GET_LONG_LE() FT_GET_MACRO( FT_Stream_GetULongLE, FT_Int32 ) |
||||
#define FT_GET_ULONG_LE() FT_GET_MACRO( FT_Stream_GetULongLE, FT_UInt32 ) |
||||
#endif |
||||
|
||||
|
||||
#define FT_READ_MACRO( func, type, var ) \ |
||||
( var = (type)func( stream, &error ), \
|
||||
error != FT_Err_Ok ) |
||||
|
||||
/*
|
||||
* The `FT_READ_XXX' macros use implicit `stream' and `error' variables. |
||||
* |
||||
* `FT_READ_XXX' can be controlled with `FT_STREAM_SEEK' and |
||||
* `FT_STREAM_POS'. They use the full machinery to check whether a read is |
||||
* valid. |
||||
*/ |
||||
#define FT_READ_BYTE( var ) FT_READ_MACRO( FT_Stream_ReadByte, FT_Byte, var ) |
||||
#define FT_READ_CHAR( var ) FT_READ_MACRO( FT_Stream_ReadByte, FT_Char, var ) |
||||
#define FT_READ_SHORT( var ) FT_READ_MACRO( FT_Stream_ReadUShort, FT_Int16, var ) |
||||
#define FT_READ_USHORT( var ) FT_READ_MACRO( FT_Stream_ReadUShort, FT_UInt16, var ) |
||||
#define FT_READ_UOFF3( var ) FT_READ_MACRO( FT_Stream_ReadUOffset, FT_UInt32, var ) |
||||
#define FT_READ_LONG( var ) FT_READ_MACRO( FT_Stream_ReadULong, FT_Int32, var ) |
||||
#define FT_READ_ULONG( var ) FT_READ_MACRO( FT_Stream_ReadULong, FT_UInt32, var ) |
||||
|
||||
#define FT_READ_SHORT_LE( var ) FT_READ_MACRO( FT_Stream_ReadUShortLE, FT_Int16, var ) |
||||
#define FT_READ_USHORT_LE( var ) FT_READ_MACRO( FT_Stream_ReadUShortLE, FT_UInt16, var ) |
||||
#define FT_READ_LONG_LE( var ) FT_READ_MACRO( FT_Stream_ReadULongLE, FT_Int32, var ) |
||||
#define FT_READ_ULONG_LE( var ) FT_READ_MACRO( FT_Stream_ReadULongLE, FT_UInt32, var ) |
||||
|
||||
|
||||
#ifndef FT_CONFIG_OPTION_NO_DEFAULT_SYSTEM |
||||
|
||||
/* initialize a stream for reading a regular system stream */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_Open( FT_Stream stream, |
||||
const char* filepathname ); |
||||
|
||||
#endif /* FT_CONFIG_OPTION_NO_DEFAULT_SYSTEM */ |
||||
|
||||
|
||||
/* create a new (input) stream from an FT_Open_Args structure */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_New( FT_Library library, |
||||
const FT_Open_Args* args, |
||||
FT_Stream *astream ); |
||||
|
||||
/* free a stream */ |
||||
FT_BASE( void ) |
||||
FT_Stream_Free( FT_Stream stream, |
||||
FT_Int external ); |
||||
|
||||
/* initialize a stream for reading in-memory data */ |
||||
FT_BASE( void ) |
||||
FT_Stream_OpenMemory( FT_Stream stream, |
||||
const FT_Byte* base, |
||||
FT_ULong size ); |
||||
|
||||
/* close a stream (does not destroy the stream structure) */ |
||||
FT_BASE( void ) |
||||
FT_Stream_Close( FT_Stream stream ); |
||||
|
||||
|
||||
/* seek within a stream. position is relative to start of stream */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_Seek( FT_Stream stream, |
||||
FT_ULong pos ); |
||||
|
||||
/* skip bytes in a stream */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_Skip( FT_Stream stream, |
||||
FT_Long distance ); |
||||
|
||||
/* return current stream position */ |
||||
FT_BASE( FT_ULong ) |
||||
FT_Stream_Pos( FT_Stream stream ); |
||||
|
||||
/* read bytes from a stream into a user-allocated buffer, returns an */ |
||||
/* error if not all bytes could be read. */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_Read( FT_Stream stream, |
||||
FT_Byte* buffer, |
||||
FT_ULong count ); |
||||
|
||||
/* read bytes from a stream at a given position */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_ReadAt( FT_Stream stream, |
||||
FT_ULong pos, |
||||
FT_Byte* buffer, |
||||
FT_ULong count ); |
||||
|
||||
/* try to read bytes at the end of a stream; return number of bytes */ |
||||
/* really available */ |
||||
FT_BASE( FT_ULong ) |
||||
FT_Stream_TryRead( FT_Stream stream, |
||||
FT_Byte* buffer, |
||||
FT_ULong count ); |
||||
|
||||
/* Enter a frame of `count' consecutive bytes in a stream. Returns an */ |
||||
/* error if the frame could not be read/accessed. The caller can use */ |
||||
/* the `FT_Stream_GetXXX' functions to retrieve frame data without */ |
||||
/* error checks. */ |
||||
/* */ |
||||
/* You must _always_ call `FT_Stream_ExitFrame' once you have entered */ |
||||
/* a stream frame! */ |
||||
/* */ |
||||
/* Nested frames are not permitted. */ |
||||
/* */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_EnterFrame( FT_Stream stream, |
||||
FT_ULong count ); |
||||
|
||||
/* exit a stream frame */ |
||||
FT_BASE( void ) |
||||
FT_Stream_ExitFrame( FT_Stream stream ); |
||||
|
||||
|
||||
/* Extract a stream frame. If the stream is disk-based, a heap block */ |
||||
/* is allocated and the frame bytes are read into it. If the stream */ |
||||
/* is memory-based, this function simply sets a pointer to the data. */ |
||||
/* */ |
||||
/* Useful to optimize access to memory-based streams transparently. */ |
||||
/* */ |
||||
/* `FT_Stream_GetXXX' functions can't be used. */ |
||||
/* */ |
||||
/* An extracted frame must be `freed' with a call to the function */ |
||||
/* `FT_Stream_ReleaseFrame'. */ |
||||
/* */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_ExtractFrame( FT_Stream stream, |
||||
FT_ULong count, |
||||
FT_Byte** pbytes ); |
||||
|
||||
/* release an extract frame (see `FT_Stream_ExtractFrame') */ |
||||
FT_BASE( void ) |
||||
FT_Stream_ReleaseFrame( FT_Stream stream, |
||||
FT_Byte** pbytes ); |
||||
|
||||
|
||||
/* read a byte from an entered frame */ |
||||
FT_BASE( FT_Byte ) |
||||
FT_Stream_GetByte( FT_Stream stream ); |
||||
|
||||
/* read a 16-bit big-endian unsigned integer from an entered frame */ |
||||
FT_BASE( FT_UInt16 ) |
||||
FT_Stream_GetUShort( FT_Stream stream ); |
||||
|
||||
/* read a 24-bit big-endian unsigned integer from an entered frame */ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Stream_GetUOffset( FT_Stream stream ); |
||||
|
||||
/* read a 32-bit big-endian unsigned integer from an entered frame */ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Stream_GetULong( FT_Stream stream ); |
||||
|
||||
/* read a 16-bit little-endian unsigned integer from an entered frame */ |
||||
FT_BASE( FT_UInt16 ) |
||||
FT_Stream_GetUShortLE( FT_Stream stream ); |
||||
|
||||
/* read a 32-bit little-endian unsigned integer from an entered frame */ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Stream_GetULongLE( FT_Stream stream ); |
||||
|
||||
|
||||
/* read a byte from a stream */ |
||||
FT_BASE( FT_Byte ) |
||||
FT_Stream_ReadByte( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* read a 16-bit big-endian unsigned integer from a stream */ |
||||
FT_BASE( FT_UInt16 ) |
||||
FT_Stream_ReadUShort( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* read a 24-bit big-endian unsigned integer from a stream */ |
||||
FT_BASE( FT_ULong ) |
||||
FT_Stream_ReadUOffset( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* read a 32-bit big-endian integer from a stream */ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Stream_ReadULong( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* read a 16-bit little-endian unsigned integer from a stream */ |
||||
FT_BASE( FT_UInt16 ) |
||||
FT_Stream_ReadUShortLE( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* read a 32-bit little-endian unsigned integer from a stream */ |
||||
FT_BASE( FT_UInt32 ) |
||||
FT_Stream_ReadULongLE( FT_Stream stream, |
||||
FT_Error* error ); |
||||
|
||||
/* Read a structure from a stream. The structure must be described */ |
||||
/* by an array of FT_Frame_Field records. */ |
||||
FT_BASE( FT_Error ) |
||||
FT_Stream_ReadFields( FT_Stream stream, |
||||
const FT_Frame_Field* fields, |
||||
void* structure ); |
||||
|
||||
|
||||
#define FT_STREAM_POS() \ |
||||
FT_Stream_Pos( stream ) |
||||
|
||||
#define FT_STREAM_SEEK( position ) \ |
||||
FT_SET_ERROR( FT_Stream_Seek( stream, \
|
||||
(FT_ULong)(position) ) ) |
||||
|
||||
#define FT_STREAM_SKIP( distance ) \ |
||||
FT_SET_ERROR( FT_Stream_Skip( stream, \
|
||||
(FT_Long)(distance) ) ) |
||||
|
||||
#define FT_STREAM_READ( buffer, count ) \ |
||||
FT_SET_ERROR( FT_Stream_Read( stream, \
|
||||
(FT_Byte*)(buffer), \
|
||||
(FT_ULong)(count) ) ) |
||||
|
||||
#define FT_STREAM_READ_AT( position, buffer, count ) \ |
||||
FT_SET_ERROR( FT_Stream_ReadAt( stream, \
|
||||
(FT_ULong)(position), \
|
||||
(FT_Byte*)(buffer), \
|
||||
(FT_ULong)(count) ) ) |
||||
|
||||
#define FT_STREAM_READ_FIELDS( fields, object ) \ |
||||
FT_SET_ERROR( FT_Stream_ReadFields( stream, fields, object ) ) |
||||
|
||||
|
||||
#define FT_FRAME_ENTER( size ) \ |
||||
FT_SET_ERROR( \
|
||||
FT_DEBUG_INNER( FT_Stream_EnterFrame( stream, \
|
||||
(FT_ULong)(size) ) ) ) |
||||
|
||||
#define FT_FRAME_EXIT() \ |
||||
FT_DEBUG_INNER( FT_Stream_ExitFrame( stream ) ) |
||||
|
||||
#define FT_FRAME_EXTRACT( size, bytes ) \ |
||||
FT_SET_ERROR( \
|
||||
FT_DEBUG_INNER( FT_Stream_ExtractFrame( stream, \
|
||||
(FT_ULong)(size), \
|
||||
(FT_Byte**)&(bytes) ) ) ) |
||||
|
||||
#define FT_FRAME_RELEASE( bytes ) \ |
||||
FT_DEBUG_INNER( FT_Stream_ReleaseFrame( stream, \
|
||||
(FT_Byte**)&(bytes) ) ) |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTSTREAM_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,172 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* fttrace.h |
||||
* |
||||
* Tracing handling (specification only). |
||||
* |
||||
* Copyright (C) 2002-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/* definitions of trace levels for FreeType 2 */ |
||||
|
||||
/* the maximum string length (if the argument to `FT_TRACE_DEF` */ |
||||
/* gets used as a string) plus one charachter for ':' plus */ |
||||
/* another one for the trace level */ |
||||
#define FT_MAX_TRACE_LEVEL_LENGTH (9 + 1 + 1) |
||||
|
||||
/* the first level must always be `trace_any' */ |
||||
FT_TRACE_DEF( any ) |
||||
|
||||
/* base components */ |
||||
FT_TRACE_DEF( calc ) /* calculations (ftcalc.c) */ |
||||
FT_TRACE_DEF( gloader ) /* glyph loader (ftgloadr.c) */ |
||||
FT_TRACE_DEF( glyph ) /* glyph management (ftglyph.c) */ |
||||
FT_TRACE_DEF( memory ) /* memory manager (ftobjs.c) */ |
||||
FT_TRACE_DEF( init ) /* initialization (ftinit.c) */ |
||||
FT_TRACE_DEF( io ) /* i/o interface (ftsystem.c) */ |
||||
FT_TRACE_DEF( list ) /* list management (ftlist.c) */ |
||||
FT_TRACE_DEF( objs ) /* base objects (ftobjs.c) */ |
||||
FT_TRACE_DEF( outline ) /* outline management (ftoutln.c) */ |
||||
FT_TRACE_DEF( stream ) /* stream manager (ftstream.c) */ |
||||
|
||||
FT_TRACE_DEF( bitmap ) /* bitmap manipulation (ftbitmap.c) */ |
||||
FT_TRACE_DEF( checksum ) /* bitmap checksum (ftobjs.c) */ |
||||
FT_TRACE_DEF( mm ) /* MM interface (ftmm.c) */ |
||||
FT_TRACE_DEF( psprops ) /* PS driver properties (ftpsprop.c) */ |
||||
FT_TRACE_DEF( raccess ) /* resource fork accessor (ftrfork.c) */ |
||||
FT_TRACE_DEF( synth ) /* bold/slant synthesizer (ftsynth.c) */ |
||||
|
||||
/* rasterizers */ |
||||
FT_TRACE_DEF( raster ) /* monochrome rasterizer (ftraster.c) */ |
||||
FT_TRACE_DEF( smooth ) /* anti-aliasing raster (ftgrays.c) */ |
||||
|
||||
/* ot-svg module */ |
||||
FT_TRACE_DEF( otsvg ) /* OT-SVG renderer (ftsvg.c) */ |
||||
|
||||
/* cache sub-system */ |
||||
FT_TRACE_DEF( cache ) /* cache sub-system (ftcache.c, etc.) */ |
||||
|
||||
/* SFNT driver components */ |
||||
FT_TRACE_DEF( sfdriver ) /* SFNT font driver (sfdriver.c) */ |
||||
FT_TRACE_DEF( sfobjs ) /* SFNT object handler (sfobjs.c) */ |
||||
FT_TRACE_DEF( sfwoff ) /* WOFF format handler (sfwoff.c) */ |
||||
FT_TRACE_DEF( sfwoff2 ) /* WOFF2 format handler (sfwoff2.c) */ |
||||
FT_TRACE_DEF( ttbdf ) /* TrueType embedded BDF (ttbdf.c) */ |
||||
FT_TRACE_DEF( ttcmap ) /* charmap handler (ttcmap.c) */ |
||||
FT_TRACE_DEF( ttcolr ) /* glyph layer table (ttcolr.c) */ |
||||
FT_TRACE_DEF( ttcpal ) /* color palette table (ttcpal.c) */ |
||||
FT_TRACE_DEF( ttsvg ) /* OpenType SVG table (ttsvg.c) */ |
||||
FT_TRACE_DEF( ttkern ) /* kerning handler (ttkern.c) */ |
||||
FT_TRACE_DEF( ttload ) /* basic TrueType tables (ttload.c) */ |
||||
FT_TRACE_DEF( ttmtx ) /* metrics-related tables (ttmtx.c) */ |
||||
FT_TRACE_DEF( ttpost ) /* PS table processing (ttpost.c) */ |
||||
FT_TRACE_DEF( ttsbit ) /* TrueType sbit handling (ttsbit.c) */ |
||||
|
||||
/* TrueType driver components */ |
||||
FT_TRACE_DEF( ttdriver ) /* TT font driver (ttdriver.c) */ |
||||
FT_TRACE_DEF( ttgload ) /* TT glyph loader (ttgload.c) */ |
||||
FT_TRACE_DEF( ttgxvar ) /* TrueType GX var handler (ttgxvar.c) */ |
||||
FT_TRACE_DEF( ttinterp ) /* bytecode interpreter (ttinterp.c) */ |
||||
FT_TRACE_DEF( ttobjs ) /* TT objects manager (ttobjs.c) */ |
||||
FT_TRACE_DEF( ttpload ) /* TT data/program loader (ttpload.c) */ |
||||
|
||||
/* Type 1 driver components */ |
||||
FT_TRACE_DEF( t1afm ) |
||||
FT_TRACE_DEF( t1driver ) |
||||
FT_TRACE_DEF( t1gload ) |
||||
FT_TRACE_DEF( t1load ) |
||||
FT_TRACE_DEF( t1objs ) |
||||
FT_TRACE_DEF( t1parse ) |
||||
|
||||
/* PostScript helper module `psaux' */ |
||||
FT_TRACE_DEF( afmparse ) |
||||
FT_TRACE_DEF( cffdecode ) |
||||
FT_TRACE_DEF( psconv ) |
||||
FT_TRACE_DEF( psobjs ) |
||||
FT_TRACE_DEF( t1decode ) |
||||
|
||||
/* PostScript hinting module `pshinter' */ |
||||
FT_TRACE_DEF( pshalgo ) |
||||
FT_TRACE_DEF( pshrec ) |
||||
|
||||
/* Type 2 driver components */ |
||||
FT_TRACE_DEF( cffdriver ) |
||||
FT_TRACE_DEF( cffgload ) |
||||
FT_TRACE_DEF( cffload ) |
||||
FT_TRACE_DEF( cffobjs ) |
||||
FT_TRACE_DEF( cffparse ) |
||||
|
||||
FT_TRACE_DEF( cf2blues ) |
||||
FT_TRACE_DEF( cf2hints ) |
||||
FT_TRACE_DEF( cf2interp ) |
||||
|
||||
/* Type 42 driver component */ |
||||
FT_TRACE_DEF( t42 ) |
||||
|
||||
/* CID driver components */ |
||||
FT_TRACE_DEF( ciddriver ) |
||||
FT_TRACE_DEF( cidgload ) |
||||
FT_TRACE_DEF( cidload ) |
||||
FT_TRACE_DEF( cidobjs ) |
||||
FT_TRACE_DEF( cidparse ) |
||||
|
||||
/* Windows font component */ |
||||
FT_TRACE_DEF( winfnt ) |
||||
|
||||
/* PCF font components */ |
||||
FT_TRACE_DEF( pcfdriver ) |
||||
FT_TRACE_DEF( pcfread ) |
||||
|
||||
/* BDF font components */ |
||||
FT_TRACE_DEF( bdfdriver ) |
||||
FT_TRACE_DEF( bdflib ) |
||||
|
||||
/* PFR font component */ |
||||
FT_TRACE_DEF( pfr ) |
||||
|
||||
/* OpenType validation components */ |
||||
FT_TRACE_DEF( otvcommon ) |
||||
FT_TRACE_DEF( otvbase ) |
||||
FT_TRACE_DEF( otvgdef ) |
||||
FT_TRACE_DEF( otvgpos ) |
||||
FT_TRACE_DEF( otvgsub ) |
||||
FT_TRACE_DEF( otvjstf ) |
||||
FT_TRACE_DEF( otvmath ) |
||||
FT_TRACE_DEF( otvmodule ) |
||||
|
||||
/* TrueTypeGX/AAT validation components */ |
||||
FT_TRACE_DEF( gxvbsln ) |
||||
FT_TRACE_DEF( gxvcommon ) |
||||
FT_TRACE_DEF( gxvfeat ) |
||||
FT_TRACE_DEF( gxvjust ) |
||||
FT_TRACE_DEF( gxvkern ) |
||||
FT_TRACE_DEF( gxvmodule ) |
||||
FT_TRACE_DEF( gxvmort ) |
||||
FT_TRACE_DEF( gxvmorx ) |
||||
FT_TRACE_DEF( gxvlcar ) |
||||
FT_TRACE_DEF( gxvopbd ) |
||||
FT_TRACE_DEF( gxvprop ) |
||||
FT_TRACE_DEF( gxvtrak ) |
||||
|
||||
/* autofit components */ |
||||
FT_TRACE_DEF( afcjk ) |
||||
FT_TRACE_DEF( afglobal ) |
||||
FT_TRACE_DEF( afhints ) |
||||
FT_TRACE_DEF( afmodule ) |
||||
FT_TRACE_DEF( aflatin ) |
||||
FT_TRACE_DEF( afshaper ) |
||||
|
||||
/* SDF components */ |
||||
FT_TRACE_DEF( sdf ) /* signed distance raster for outlines (ftsdf.c) */ |
||||
FT_TRACE_DEF( bsdf ) /* signed distance raster for bitmaps (ftbsdf.c) */ |
||||
|
||||
/* END */ |
||||
@ -0,0 +1,160 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftvalid.h |
||||
* |
||||
* FreeType validation support (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef FTVALID_H_ |
||||
#define FTVALID_H_ |
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_STANDARD_LIBRARY_H /* for ft_jmpbuf */ |
||||
|
||||
#include "compiler-macros.h" |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/**** ****/ |
||||
/**** ****/ |
||||
/**** V A L I D A T I O N ****/ |
||||
/**** ****/ |
||||
/**** ****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
/* handle to a validation object */ |
||||
typedef struct FT_ValidatorRec_ volatile* FT_Validator; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* There are three distinct validation levels defined here: |
||||
* |
||||
* FT_VALIDATE_DEFAULT :: |
||||
* A table that passes this validation level can be used reliably by |
||||
* FreeType. It generally means that all offsets have been checked to |
||||
* prevent out-of-bound reads, that array counts are correct, etc. |
||||
* |
||||
* FT_VALIDATE_TIGHT :: |
||||
* A table that passes this validation level can be used reliably and |
||||
* doesn't contain invalid data. For example, a charmap table that |
||||
* returns invalid glyph indices will not pass, even though it can be |
||||
* used with FreeType in default mode (the library will simply return an |
||||
* error later when trying to load the glyph). |
||||
* |
||||
* It also checks that fields which must be a multiple of 2, 4, or 8, |
||||
* don't have incorrect values, etc. |
||||
* |
||||
* FT_VALIDATE_PARANOID :: |
||||
* Only for font debugging. Checks that a table follows the |
||||
* specification by 100%. Very few fonts will be able to pass this level |
||||
* anyway but it can be useful for certain tools like font |
||||
* editors/converters. |
||||
*/ |
||||
typedef enum FT_ValidationLevel_ |
||||
{ |
||||
FT_VALIDATE_DEFAULT = 0, |
||||
FT_VALIDATE_TIGHT, |
||||
FT_VALIDATE_PARANOID |
||||
|
||||
} FT_ValidationLevel; |
||||
|
||||
|
||||
#if defined( _MSC_VER ) /* Visual C++ (and Intel C++) */ |
||||
/* We disable the warning `structure was padded due to */ |
||||
/* __declspec(align())' in order to compile cleanly with */ |
||||
/* the maximum level of warnings. */ |
||||
#pragma warning( push ) |
||||
#pragma warning( disable : 4324 ) |
||||
#endif /* _MSC_VER */ |
||||
|
||||
/* validator structure */ |
||||
typedef struct FT_ValidatorRec_ |
||||
{ |
||||
ft_jmp_buf jump_buffer; /* used for exception handling */ |
||||
|
||||
const FT_Byte* base; /* address of table in memory */ |
||||
const FT_Byte* limit; /* `base' + sizeof(table) in memory */ |
||||
FT_ValidationLevel level; /* validation level */ |
||||
FT_Error error; /* error returned. 0 means success */ |
||||
|
||||
} FT_ValidatorRec; |
||||
|
||||
#if defined( _MSC_VER ) |
||||
#pragma warning( pop ) |
||||
#endif |
||||
|
||||
#define FT_VALIDATOR( x ) ( (FT_Validator)( x ) ) |
||||
|
||||
|
||||
FT_BASE( void ) |
||||
ft_validator_init( FT_Validator valid, |
||||
const FT_Byte* base, |
||||
const FT_Byte* limit, |
||||
FT_ValidationLevel level ); |
||||
|
||||
/* Do not use this. It's broken and will cause your validator to crash */ |
||||
/* if you run it on an invalid font. */ |
||||
FT_BASE( FT_Int ) |
||||
ft_validator_run( FT_Validator valid ); |
||||
|
||||
/* Sets the error field in a validator, then calls `longjmp' to return */ |
||||
/* to high-level caller. Using `setjmp/longjmp' avoids many stupid */ |
||||
/* error checks within the validation routines. */ |
||||
/* */ |
||||
FT_BASE( void ) |
||||
ft_validator_error( FT_Validator valid, |
||||
FT_Error error ); |
||||
|
||||
|
||||
/* Calls ft_validate_error. Assumes that the `valid' local variable */ |
||||
/* holds a pointer to the current validator object. */ |
||||
/* */ |
||||
#define FT_INVALID( _error ) FT_INVALID_( _error ) |
||||
#define FT_INVALID_( _error ) \ |
||||
ft_validator_error( valid, FT_THROW( _error ) ) |
||||
|
||||
/* called when a broken table is detected */ |
||||
#define FT_INVALID_TOO_SHORT \ |
||||
FT_INVALID( Invalid_Table ) |
||||
|
||||
/* called when an invalid offset is detected */ |
||||
#define FT_INVALID_OFFSET \ |
||||
FT_INVALID( Invalid_Offset ) |
||||
|
||||
/* called when an invalid format/value is detected */ |
||||
#define FT_INVALID_FORMAT \ |
||||
FT_INVALID( Invalid_Table ) |
||||
|
||||
/* called when an invalid glyph index is detected */ |
||||
#define FT_INVALID_GLYPH_ID \ |
||||
FT_INVALID( Invalid_Glyph_Index ) |
||||
|
||||
/* called when an invalid field value is detected */ |
||||
#define FT_INVALID_DATA \ |
||||
FT_INVALID( Invalid_Table ) |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FTVALID_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,699 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* pshints.h |
||||
* |
||||
* Interface to Postscript-specific (Type 1 and Type 2) hints |
||||
* recorders (specification only). These are used to support native |
||||
* T1/T2 hints in the 'type1', 'cid', and 'cff' font drivers. |
||||
* |
||||
* Copyright (C) 2001-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef PSHINTS_H_ |
||||
#define PSHINTS_H_ |
||||
|
||||
|
||||
#include <freetype/freetype.h> |
||||
#include <freetype/t1tables.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/***** *****/ |
||||
/***** INTERNAL REPRESENTATION OF GLOBALS *****/ |
||||
/***** *****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
typedef struct PSH_GlobalsRec_* PSH_Globals; |
||||
|
||||
typedef FT_Error |
||||
(*PSH_Globals_NewFunc)( FT_Memory memory, |
||||
T1_Private* private_dict, |
||||
PSH_Globals* aglobals ); |
||||
|
||||
typedef void |
||||
(*PSH_Globals_SetScaleFunc)( PSH_Globals globals, |
||||
FT_Fixed x_scale, |
||||
FT_Fixed y_scale, |
||||
FT_Fixed x_delta, |
||||
FT_Fixed y_delta ); |
||||
|
||||
typedef void |
||||
(*PSH_Globals_DestroyFunc)( PSH_Globals globals ); |
||||
|
||||
|
||||
typedef struct PSH_Globals_FuncsRec_ |
||||
{ |
||||
PSH_Globals_NewFunc create; |
||||
PSH_Globals_SetScaleFunc set_scale; |
||||
PSH_Globals_DestroyFunc destroy; |
||||
|
||||
} PSH_Globals_FuncsRec, *PSH_Globals_Funcs; |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/***** *****/ |
||||
/***** PUBLIC TYPE 1 HINTS RECORDER *****/ |
||||
/***** *****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* T1_Hints |
||||
* |
||||
* @description: |
||||
* This is a handle to an opaque structure used to record glyph hints |
||||
* from a Type 1 character glyph character string. |
||||
* |
||||
* The methods used to operate on this object are defined by the |
||||
* @T1_Hints_FuncsRec structure. Recording glyph hints is normally |
||||
* achieved through the following scheme: |
||||
* |
||||
* - Open a new hint recording session by calling the 'open' method. |
||||
* This rewinds the recorder and prepare it for new input. |
||||
* |
||||
* - For each hint found in the glyph charstring, call the corresponding |
||||
* method ('stem', 'stem3', or 'reset'). Note that these functions do |
||||
* not return an error code. |
||||
* |
||||
* - Close the recording session by calling the 'close' method. It |
||||
* returns an error code if the hints were invalid or something strange |
||||
* happened (e.g., memory shortage). |
||||
* |
||||
* The hints accumulated in the object can later be used by the |
||||
* PostScript hinter. |
||||
* |
||||
*/ |
||||
typedef struct T1_HintsRec_* T1_Hints; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* T1_Hints_Funcs |
||||
* |
||||
* @description: |
||||
* A pointer to the @T1_Hints_FuncsRec structure that defines the API of |
||||
* a given @T1_Hints object. |
||||
* |
||||
*/ |
||||
typedef const struct T1_Hints_FuncsRec_* T1_Hints_Funcs; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_OpenFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to prepare it for a new Type 1 |
||||
* hints recording session. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* @note: |
||||
* You should always call the @T1_Hints_CloseFunc method in order to |
||||
* close an opened recording session. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T1_Hints_OpenFunc)( T1_Hints hints ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_SetStemFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to record a new horizontal or |
||||
* vertical stem. This corresponds to the Type 1 'hstem' and 'vstem' |
||||
* operators. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* dimension :: |
||||
* 0 for horizontal stems (hstem), 1 for vertical ones (vstem). |
||||
* |
||||
* coords :: |
||||
* Array of 2 coordinates in 16.16 format, used as (position,length) |
||||
* stem descriptor. |
||||
* |
||||
* @note: |
||||
* Use vertical coordinates (y) for horizontal stems (dim=0). Use |
||||
* horizontal coordinates (x) for vertical stems (dim=1). |
||||
* |
||||
* 'coords[0]' is the absolute stem position (lowest coordinate); |
||||
* 'coords[1]' is the length. |
||||
* |
||||
* The length can be negative, in which case it must be either -20 or |
||||
* -21. It is interpreted as a 'ghost' stem, according to the Type 1 |
||||
* specification. |
||||
* |
||||
* If the length is -21 (corresponding to a bottom ghost stem), then the |
||||
* real stem position is 'coords[0]+coords[1]'. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T1_Hints_SetStemFunc)( T1_Hints hints, |
||||
FT_UInt dimension, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_SetStem3Func |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to record three |
||||
* counter-controlled horizontal or vertical stems at once. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* dimension :: |
||||
* 0 for horizontal stems, 1 for vertical ones. |
||||
* |
||||
* coords :: |
||||
* An array of 6 values in 16.16 format, holding 3 (position,length) |
||||
* pairs for the counter-controlled stems. |
||||
* |
||||
* @note: |
||||
* Use vertical coordinates (y) for horizontal stems (dim=0). Use |
||||
* horizontal coordinates (x) for vertical stems (dim=1). |
||||
* |
||||
* The lengths cannot be negative (ghost stems are never |
||||
* counter-controlled). |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T1_Hints_SetStem3Func)( T1_Hints hints, |
||||
FT_UInt dimension, |
||||
FT_Fixed* coords ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_ResetFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to reset the stems hints in a |
||||
* recording session. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* end_point :: |
||||
* The index of the last point in the input glyph in which the |
||||
* previously defined hints apply. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T1_Hints_ResetFunc)( T1_Hints hints, |
||||
FT_UInt end_point ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_CloseFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to close a hint recording |
||||
* session. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* end_point :: |
||||
* The index of the last point in the input glyph. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* The error code is set to indicate that an error occurred during the |
||||
* recording session. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*T1_Hints_CloseFunc)( T1_Hints hints, |
||||
FT_UInt end_point ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T1_Hints_ApplyFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T1_Hints class used to apply hints to the |
||||
* corresponding glyph outline. Must be called once all hints have been |
||||
* recorded. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 1 hints recorder. |
||||
* |
||||
* outline :: |
||||
* A pointer to the target outline descriptor. |
||||
* |
||||
* globals :: |
||||
* The hinter globals for this font. |
||||
* |
||||
* hint_mode :: |
||||
* Hinting information. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* On input, all points within the outline are in font coordinates. On |
||||
* output, they are in 1/64 of pixels. |
||||
* |
||||
* The scaling transformation is taken from the 'globals' object which |
||||
* must correspond to the same font as the glyph. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*T1_Hints_ApplyFunc)( T1_Hints hints, |
||||
FT_Outline* outline, |
||||
PSH_Globals globals, |
||||
FT_Render_Mode hint_mode ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* T1_Hints_FuncsRec |
||||
* |
||||
* @description: |
||||
* The structure used to provide the API to @T1_Hints objects. |
||||
* |
||||
* @fields: |
||||
* hints :: |
||||
* A handle to the T1 Hints recorder. |
||||
* |
||||
* open :: |
||||
* The function to open a recording session. |
||||
* |
||||
* close :: |
||||
* The function to close a recording session. |
||||
* |
||||
* stem :: |
||||
* The function to set a simple stem. |
||||
* |
||||
* stem3 :: |
||||
* The function to set counter-controlled stems. |
||||
* |
||||
* reset :: |
||||
* The function to reset stem hints. |
||||
* |
||||
* apply :: |
||||
* The function to apply the hints to the corresponding glyph outline. |
||||
* |
||||
*/ |
||||
typedef struct T1_Hints_FuncsRec_ |
||||
{ |
||||
T1_Hints hints; |
||||
T1_Hints_OpenFunc open; |
||||
T1_Hints_CloseFunc close; |
||||
T1_Hints_SetStemFunc stem; |
||||
T1_Hints_SetStem3Func stem3; |
||||
T1_Hints_ResetFunc reset; |
||||
T1_Hints_ApplyFunc apply; |
||||
|
||||
} T1_Hints_FuncsRec; |
||||
|
||||
|
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
/***** *****/ |
||||
/***** PUBLIC TYPE 2 HINTS RECORDER *****/ |
||||
/***** *****/ |
||||
/*************************************************************************/ |
||||
/*************************************************************************/ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* T2_Hints |
||||
* |
||||
* @description: |
||||
* This is a handle to an opaque structure used to record glyph hints |
||||
* from a Type 2 character glyph character string. |
||||
* |
||||
* The methods used to operate on this object are defined by the |
||||
* @T2_Hints_FuncsRec structure. Recording glyph hints is normally |
||||
* achieved through the following scheme: |
||||
* |
||||
* - Open a new hint recording session by calling the 'open' method. |
||||
* This rewinds the recorder and prepare it for new input. |
||||
* |
||||
* - For each hint found in the glyph charstring, call the corresponding |
||||
* method ('stems', 'hintmask', 'counters'). Note that these functions |
||||
* do not return an error code. |
||||
* |
||||
* - Close the recording session by calling the 'close' method. It |
||||
* returns an error code if the hints were invalid or something strange |
||||
* happened (e.g., memory shortage). |
||||
* |
||||
* The hints accumulated in the object can later be used by the |
||||
* Postscript hinter. |
||||
* |
||||
*/ |
||||
typedef struct T2_HintsRec_* T2_Hints; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* T2_Hints_Funcs |
||||
* |
||||
* @description: |
||||
* A pointer to the @T2_Hints_FuncsRec structure that defines the API of |
||||
* a given @T2_Hints object. |
||||
* |
||||
*/ |
||||
typedef const struct T2_Hints_FuncsRec_* T2_Hints_Funcs; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_OpenFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to prepare it for a new Type 2 |
||||
* hints recording session. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* @note: |
||||
* You should always call the @T2_Hints_CloseFunc method in order to |
||||
* close an opened recording session. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T2_Hints_OpenFunc)( T2_Hints hints ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_StemsFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to set the table of stems in |
||||
* either the vertical or horizontal dimension. Equivalent to the |
||||
* 'hstem', 'vstem', 'hstemhm', and 'vstemhm' Type 2 operators. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* dimension :: |
||||
* 0 for horizontal stems (hstem), 1 for vertical ones (vstem). |
||||
* |
||||
* count :: |
||||
* The number of stems. |
||||
* |
||||
* coords :: |
||||
* An array of 'count' (position,length) pairs in 16.16 format. |
||||
* |
||||
* @note: |
||||
* Use vertical coordinates (y) for horizontal stems (dim=0). Use |
||||
* horizontal coordinates (x) for vertical stems (dim=1). |
||||
* |
||||
* There are '2*count' elements in the 'coords' array. Each even element |
||||
* is an absolute position in font units, each odd element is a length in |
||||
* font units. |
||||
* |
||||
* A length can be negative, in which case it must be either -20 or -21. |
||||
* It is interpreted as a 'ghost' stem, according to the Type 1 |
||||
* specification. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T2_Hints_StemsFunc)( T2_Hints hints, |
||||
FT_UInt dimension, |
||||
FT_Int count, |
||||
FT_Fixed* coordinates ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_MaskFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to set a given hintmask (this |
||||
* corresponds to the 'hintmask' Type 2 operator). |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* end_point :: |
||||
* The glyph index of the last point to which the previously defined or |
||||
* activated hints apply. |
||||
* |
||||
* bit_count :: |
||||
* The number of bits in the hint mask. |
||||
* |
||||
* bytes :: |
||||
* An array of bytes modelling the hint mask. |
||||
* |
||||
* @note: |
||||
* If the hintmask starts the charstring (before any glyph point |
||||
* definition), the value of `end_point` should be 0. |
||||
* |
||||
* `bit_count` is the number of meaningful bits in the 'bytes' array; it |
||||
* must be equal to the total number of hints defined so far (i.e., |
||||
* horizontal+verticals). |
||||
* |
||||
* The 'bytes' array can come directly from the Type 2 charstring and |
||||
* respects the same format. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T2_Hints_MaskFunc)( T2_Hints hints, |
||||
FT_UInt end_point, |
||||
FT_UInt bit_count, |
||||
const FT_Byte* bytes ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_CounterFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to set a given counter mask (this |
||||
* corresponds to the 'hintmask' Type 2 operator). |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* end_point :: |
||||
* A glyph index of the last point to which the previously defined or |
||||
* active hints apply. |
||||
* |
||||
* bit_count :: |
||||
* The number of bits in the hint mask. |
||||
* |
||||
* bytes :: |
||||
* An array of bytes modelling the hint mask. |
||||
* |
||||
* @note: |
||||
* If the hintmask starts the charstring (before any glyph point |
||||
* definition), the value of `end_point` should be 0. |
||||
* |
||||
* `bit_count` is the number of meaningful bits in the 'bytes' array; it |
||||
* must be equal to the total number of hints defined so far (i.e., |
||||
* horizontal+verticals). |
||||
* |
||||
* The 'bytes' array can come directly from the Type 2 charstring and |
||||
* respects the same format. |
||||
* |
||||
*/ |
||||
typedef void |
||||
(*T2_Hints_CounterFunc)( T2_Hints hints, |
||||
FT_UInt bit_count, |
||||
const FT_Byte* bytes ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_CloseFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to close a hint recording |
||||
* session. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* end_point :: |
||||
* The index of the last point in the input glyph. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* The error code is set to indicate that an error occurred during the |
||||
* recording session. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*T2_Hints_CloseFunc)( T2_Hints hints, |
||||
FT_UInt end_point ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @functype: |
||||
* T2_Hints_ApplyFunc |
||||
* |
||||
* @description: |
||||
* A method of the @T2_Hints class used to apply hints to the |
||||
* corresponding glyph outline. Must be called after the 'close' method. |
||||
* |
||||
* @input: |
||||
* hints :: |
||||
* A handle to the Type 2 hints recorder. |
||||
* |
||||
* outline :: |
||||
* A pointer to the target outline descriptor. |
||||
* |
||||
* globals :: |
||||
* The hinter globals for this font. |
||||
* |
||||
* hint_mode :: |
||||
* Hinting information. |
||||
* |
||||
* @return: |
||||
* FreeType error code. 0 means success. |
||||
* |
||||
* @note: |
||||
* On input, all points within the outline are in font coordinates. On |
||||
* output, they are in 1/64 of pixels. |
||||
* |
||||
* The scaling transformation is taken from the 'globals' object which |
||||
* must correspond to the same font than the glyph. |
||||
* |
||||
*/ |
||||
typedef FT_Error |
||||
(*T2_Hints_ApplyFunc)( T2_Hints hints, |
||||
FT_Outline* outline, |
||||
PSH_Globals globals, |
||||
FT_Render_Mode hint_mode ); |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @struct: |
||||
* T2_Hints_FuncsRec |
||||
* |
||||
* @description: |
||||
* The structure used to provide the API to @T2_Hints objects. |
||||
* |
||||
* @fields: |
||||
* hints :: |
||||
* A handle to the T2 hints recorder object. |
||||
* |
||||
* open :: |
||||
* The function to open a recording session. |
||||
* |
||||
* close :: |
||||
* The function to close a recording session. |
||||
* |
||||
* stems :: |
||||
* The function to set the dimension's stems table. |
||||
* |
||||
* hintmask :: |
||||
* The function to set hint masks. |
||||
* |
||||
* counter :: |
||||
* The function to set counter masks. |
||||
* |
||||
* apply :: |
||||
* The function to apply the hints on the corresponding glyph outline. |
||||
* |
||||
*/ |
||||
typedef struct T2_Hints_FuncsRec_ |
||||
{ |
||||
T2_Hints hints; |
||||
T2_Hints_OpenFunc open; |
||||
T2_Hints_CloseFunc close; |
||||
T2_Hints_StemsFunc stems; |
||||
T2_Hints_MaskFunc hintmask; |
||||
T2_Hints_CounterFunc counter; |
||||
T2_Hints_ApplyFunc apply; |
||||
|
||||
} T2_Hints_FuncsRec; |
||||
|
||||
|
||||
/* */ |
||||
|
||||
|
||||
typedef struct PSHinter_Interface_ |
||||
{ |
||||
PSH_Globals_Funcs (*get_globals_funcs)( FT_Module module ); |
||||
T1_Hints_Funcs (*get_t1_funcs) ( FT_Module module ); |
||||
T2_Hints_Funcs (*get_t2_funcs) ( FT_Module module ); |
||||
|
||||
} PSHinter_Interface; |
||||
|
||||
typedef PSHinter_Interface* PSHinter_Service; |
||||
|
||||
|
||||
#define FT_DEFINE_PSHINTER_INTERFACE( \ |
||||
class_, \
|
||||
get_globals_funcs_, \
|
||||
get_t1_funcs_, \
|
||||
get_t2_funcs_ ) \
|
||||
static const PSHinter_Interface class_ = \
|
||||
{ \
|
||||
get_globals_funcs_, \
|
||||
get_t1_funcs_, \
|
||||
get_t2_funcs_ \
|
||||
}; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* PSHINTS_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,66 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svbdf.h |
||||
* |
||||
* The FreeType BDF services (specification). |
||||
* |
||||
* Copyright (C) 2003-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVBDF_H_ |
||||
#define SVBDF_H_ |
||||
|
||||
#include <freetype/ftbdf.h> |
||||
#include <freetype/internal/ftserv.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
#define FT_SERVICE_ID_BDF "bdf" |
||||
|
||||
typedef FT_Error |
||||
(*FT_BDF_GetCharsetIdFunc)( FT_Face face, |
||||
const char* *acharset_encoding, |
||||
const char* *acharset_registry ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_BDF_GetPropertyFunc)( FT_Face face, |
||||
const char* prop_name, |
||||
BDF_PropertyRec *aproperty ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( BDF ) |
||||
{ |
||||
FT_BDF_GetCharsetIdFunc get_charset_id; |
||||
FT_BDF_GetPropertyFunc get_property; |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_BDFRec( class_, \ |
||||
get_charset_id_, \
|
||||
get_property_ ) \
|
||||
static const FT_Service_BDFRec class_ = \
|
||||
{ \
|
||||
get_charset_id_, get_property_ \
|
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVBDF_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,90 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svcfftl.h |
||||
* |
||||
* The FreeType CFF tables loader service (specification). |
||||
* |
||||
* Copyright (C) 2017-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVCFFTL_H_ |
||||
#define SVCFFTL_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
#include <freetype/internal/cfftypes.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
#define FT_SERVICE_ID_CFF_LOAD "cff-load" |
||||
|
||||
|
||||
typedef FT_UShort |
||||
(*FT_Get_Standard_Encoding_Func)( FT_UInt charcode ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Load_Private_Dict_Func)( CFF_Font font, |
||||
CFF_SubFont subfont, |
||||
FT_UInt lenNDV, |
||||
FT_Fixed* NDV ); |
||||
|
||||
typedef FT_Byte |
||||
(*FT_FD_Select_Get_Func)( CFF_FDSelect fdselect, |
||||
FT_UInt glyph_index ); |
||||
|
||||
typedef FT_Bool |
||||
(*FT_Blend_Check_Vector_Func)( CFF_Blend blend, |
||||
FT_UInt vsindex, |
||||
FT_UInt lenNDV, |
||||
FT_Fixed* NDV ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Blend_Build_Vector_Func)( CFF_Blend blend, |
||||
FT_UInt vsindex, |
||||
FT_UInt lenNDV, |
||||
FT_Fixed* NDV ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( CFFLoad ) |
||||
{ |
||||
FT_Get_Standard_Encoding_Func get_standard_encoding; |
||||
FT_Load_Private_Dict_Func load_private_dict; |
||||
FT_FD_Select_Get_Func fd_select_get; |
||||
FT_Blend_Check_Vector_Func blend_check_vector; |
||||
FT_Blend_Build_Vector_Func blend_build_vector; |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_CFFLOADREC( class_, \ |
||||
get_standard_encoding_, \
|
||||
load_private_dict_, \
|
||||
fd_select_get_, \
|
||||
blend_check_vector_, \
|
||||
blend_build_vector_ ) \
|
||||
static const FT_Service_CFFLoadRec class_ = \
|
||||
{ \
|
||||
get_standard_encoding_, \
|
||||
load_private_dict_, \
|
||||
fd_select_get_, \
|
||||
blend_check_vector_, \
|
||||
blend_build_vector_ \
|
||||
}; |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,69 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svcid.h |
||||
* |
||||
* The FreeType CID font services (specification). |
||||
* |
||||
* Copyright (C) 2007-2023 by |
||||
* Derek Clegg and Michael Toftdal. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVCID_H_ |
||||
#define SVCID_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
#define FT_SERVICE_ID_CID "CID" |
||||
|
||||
typedef FT_Error |
||||
(*FT_CID_GetRegistryOrderingSupplementFunc)( FT_Face face, |
||||
const char* *registry, |
||||
const char* *ordering, |
||||
FT_Int *supplement ); |
||||
typedef FT_Error |
||||
(*FT_CID_GetIsInternallyCIDKeyedFunc)( FT_Face face, |
||||
FT_Bool *is_cid ); |
||||
typedef FT_Error |
||||
(*FT_CID_GetCIDFromGlyphIndexFunc)( FT_Face face, |
||||
FT_UInt glyph_index, |
||||
FT_UInt *cid ); |
||||
|
||||
FT_DEFINE_SERVICE( CID ) |
||||
{ |
||||
FT_CID_GetRegistryOrderingSupplementFunc get_ros; |
||||
FT_CID_GetIsInternallyCIDKeyedFunc get_is_cid; |
||||
FT_CID_GetCIDFromGlyphIndexFunc get_cid_from_glyph_index; |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_CIDREC( class_, \ |
||||
get_ros_, \
|
||||
get_is_cid_, \
|
||||
get_cid_from_glyph_index_ ) \
|
||||
static const FT_Service_CIDRec class_ = \
|
||||
{ \
|
||||
get_ros_, get_is_cid_, get_cid_from_glyph_index_ \
|
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVCID_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,55 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svfntfmt.h |
||||
* |
||||
* The FreeType font format service (specification only). |
||||
* |
||||
* Copyright (C) 2003-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVFNTFMT_H_ |
||||
#define SVFNTFMT_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*
|
||||
* A trivial service used to return the name of a face's font driver, |
||||
* according to the XFree86 nomenclature. Note that the service data is a |
||||
* simple constant string pointer. |
||||
*/ |
||||
|
||||
#define FT_SERVICE_ID_FONT_FORMAT "font-format" |
||||
|
||||
#define FT_FONT_FORMAT_TRUETYPE "TrueType" |
||||
#define FT_FONT_FORMAT_TYPE_1 "Type 1" |
||||
#define FT_FONT_FORMAT_BDF "BDF" |
||||
#define FT_FONT_FORMAT_PCF "PCF" |
||||
#define FT_FONT_FORMAT_TYPE_42 "Type 42" |
||||
#define FT_FONT_FORMAT_CID "CID Type 1" |
||||
#define FT_FONT_FORMAT_CFF "CFF" |
||||
#define FT_FONT_FORMAT_PFR "PFR" |
||||
#define FT_FONT_FORMAT_WINFNT "Windows FNT" |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVFNTFMT_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,72 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svgldict.h |
||||
* |
||||
* The FreeType glyph dictionary services (specification). |
||||
* |
||||
* Copyright (C) 2003-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVGLDICT_H_ |
||||
#define SVGLDICT_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*
|
||||
* A service used to retrieve glyph names, as well as to find the index of |
||||
* a given glyph name in a font. |
||||
* |
||||
*/ |
||||
|
||||
#define FT_SERVICE_ID_GLYPH_DICT "glyph-dict" |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_GlyphDict_GetNameFunc)( FT_Face face, |
||||
FT_UInt glyph_index, |
||||
FT_Pointer buffer, |
||||
FT_UInt buffer_max ); |
||||
|
||||
typedef FT_UInt |
||||
(*FT_GlyphDict_NameIndexFunc)( FT_Face face, |
||||
const FT_String* glyph_name ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( GlyphDict ) |
||||
{ |
||||
FT_GlyphDict_GetNameFunc get_name; |
||||
FT_GlyphDict_NameIndexFunc name_index; /* optional */ |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_GLYPHDICTREC( class_, \ |
||||
get_name_, \
|
||||
name_index_ ) \
|
||||
static const FT_Service_GlyphDictRec class_ = \
|
||||
{ \
|
||||
get_name_, name_index_ \
|
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVGLDICT_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,72 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svgxval.h |
||||
* |
||||
* FreeType API for validating TrueTypeGX/AAT tables (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 by |
||||
* Masatake YAMATO, Red Hat K.K., |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
/****************************************************************************
|
||||
* |
||||
* gxvalid is derived from both gxlayout module and otvalid module. |
||||
* Development of gxlayout is supported by the Information-technology |
||||
* Promotion Agency(IPA), Japan. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVGXVAL_H_ |
||||
#define SVGXVAL_H_ |
||||
|
||||
#include <freetype/ftgxval.h> |
||||
#include <freetype/internal/ftvalid.h> |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
#define FT_SERVICE_ID_GX_VALIDATE "truetypegx-validate" |
||||
#define FT_SERVICE_ID_CLASSICKERN_VALIDATE "classickern-validate" |
||||
|
||||
typedef FT_Error |
||||
(*gxv_validate_func)( FT_Face face, |
||||
FT_UInt gx_flags, |
||||
FT_Bytes tables[FT_VALIDATE_GX_LENGTH], |
||||
FT_UInt table_length ); |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*ckern_validate_func)( FT_Face face, |
||||
FT_UInt ckern_flags, |
||||
FT_Bytes *ckern_table ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( GXvalidate ) |
||||
{ |
||||
gxv_validate_func validate; |
||||
}; |
||||
|
||||
FT_DEFINE_SERVICE( CKERNvalidate ) |
||||
{ |
||||
ckern_validate_func validate; |
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVGXVAL_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,51 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svkern.h |
||||
* |
||||
* The FreeType Kerning service (specification). |
||||
* |
||||
* Copyright (C) 2006-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVKERN_H_ |
||||
#define SVKERN_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
#include <freetype/tttables.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
#define FT_SERVICE_ID_KERNING "kerning" |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Kerning_TrackGetFunc)( FT_Face face, |
||||
FT_Fixed point_size, |
||||
FT_Int degree, |
||||
FT_Fixed* akerning ); |
||||
|
||||
FT_DEFINE_SERVICE( Kerning ) |
||||
{ |
||||
FT_Kerning_TrackGetFunc get_track; |
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVKERN_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,131 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svmetric.h |
||||
* |
||||
* The FreeType services for metrics variations (specification). |
||||
* |
||||
* Copyright (C) 2016-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVMETRIC_H_ |
||||
#define SVMETRIC_H_ |
||||
|
||||
#include <freetype/internal/ftserv.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*
|
||||
* A service to manage the `HVAR, `MVAR', and `VVAR' OpenType tables. |
||||
* |
||||
*/ |
||||
|
||||
#define FT_SERVICE_ID_METRICS_VARIATIONS "metrics-variations" |
||||
|
||||
|
||||
/* HVAR */ |
||||
|
||||
typedef FT_Error |
||||
(*FT_HAdvance_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_LSB_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_RSB_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
/* VVAR */ |
||||
|
||||
typedef FT_Error |
||||
(*FT_VAdvance_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_TSB_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_BSB_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_VOrg_Adjust_Func)( FT_Face face, |
||||
FT_UInt gindex, |
||||
FT_Int *avalue ); |
||||
|
||||
/* MVAR */ |
||||
|
||||
typedef void |
||||
(*FT_Metrics_Adjust_Func)( FT_Face face ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Size_Reset_Func)( FT_Size size ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( MetricsVariations ) |
||||
{ |
||||
FT_HAdvance_Adjust_Func hadvance_adjust; |
||||
FT_LSB_Adjust_Func lsb_adjust; |
||||
FT_RSB_Adjust_Func rsb_adjust; |
||||
|
||||
FT_VAdvance_Adjust_Func vadvance_adjust; |
||||
FT_TSB_Adjust_Func tsb_adjust; |
||||
FT_BSB_Adjust_Func bsb_adjust; |
||||
FT_VOrg_Adjust_Func vorg_adjust; |
||||
|
||||
FT_Metrics_Adjust_Func metrics_adjust; |
||||
FT_Size_Reset_Func size_reset; |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_METRICSVARIATIONSREC( class_, \ |
||||
hadvance_adjust_, \
|
||||
lsb_adjust_, \
|
||||
rsb_adjust_, \
|
||||
vadvance_adjust_, \
|
||||
tsb_adjust_, \
|
||||
bsb_adjust_, \
|
||||
vorg_adjust_, \
|
||||
metrics_adjust_, \
|
||||
size_reset_ ) \
|
||||
static const FT_Service_MetricsVariationsRec class_ = \
|
||||
{ \
|
||||
hadvance_adjust_, \
|
||||
lsb_adjust_, \
|
||||
rsb_adjust_, \
|
||||
vadvance_adjust_, \
|
||||
tsb_adjust_, \
|
||||
bsb_adjust_, \
|
||||
vorg_adjust_, \
|
||||
metrics_adjust_, \
|
||||
size_reset_ \
|
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* SVMETRIC_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,214 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svmm.h |
||||
* |
||||
* The FreeType Multiple Masters and GX var services (specification). |
||||
* |
||||
* Copyright (C) 2003-2023 by |
||||
* David Turner, Robert Wilhelm, Werner Lemberg, and Dominik Röttsches. |
||||
* |
||||
* 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVMM_H_ |
||||
#define SVMM_H_ |
||||
|
||||
#include <freetype/ftmm.h> |
||||
#include <freetype/internal/ftserv.h> |
||||
#include <freetype/internal/ftmmtypes.h> |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/*
|
||||
* A service used to manage multiple-masters data in a given face. |
||||
* |
||||
* See the related APIs in `ftmm.h' (FT_MULTIPLE_MASTERS_H). |
||||
* |
||||
*/ |
||||
|
||||
#define FT_SERVICE_ID_MULTI_MASTERS "multi-masters" |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_MM_Func)( FT_Face face, |
||||
FT_Multi_Master* master ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_MM_Var_Func)( FT_Face face, |
||||
FT_MM_Var* *master ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Set_MM_Design_Func)( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Long* coords ); |
||||
|
||||
/* use return value -1 to indicate that the new coordinates */ |
||||
/* are equal to the current ones; no changes are thus needed */ |
||||
typedef FT_Error |
||||
(*FT_Set_Var_Design_Func)( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
/* use return value -1 to indicate that the new coordinates */ |
||||
/* are equal to the current ones; no changes are thus needed */ |
||||
typedef FT_Error |
||||
(*FT_Set_MM_Blend_Func)( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_Var_Design_Func)( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Set_Named_Instance_Func)( FT_Face face, |
||||
FT_UInt instance_index ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_Default_Named_Instance_Func)( FT_Face face, |
||||
FT_UInt *instance_index ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_MM_Blend_Func)( FT_Face face, |
||||
FT_UInt num_coords, |
||||
FT_Fixed* coords ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_Var_Blend_Func)( FT_Face face, |
||||
FT_UInt *num_coords, |
||||
FT_Fixed* *coords, |
||||
FT_Fixed* *normalizedcoords, |
||||
FT_MM_Var* *mm_var ); |
||||
|
||||
typedef void |
||||
(*FT_Done_Blend_Func)( FT_Face face ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Set_MM_WeightVector_Func)( FT_Face face, |
||||
FT_UInt len, |
||||
FT_Fixed* weight_vector ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Get_MM_WeightVector_Func)( FT_Face face, |
||||
FT_UInt* len, |
||||
FT_Fixed* weight_vector ); |
||||
|
||||
typedef void |
||||
(*FT_Construct_PS_Name_Func)( FT_Face face ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Var_Load_Delta_Set_Idx_Map_Func)( FT_Face face, |
||||
FT_ULong offset, |
||||
GX_DeltaSetIdxMap map, |
||||
GX_ItemVarStore itemStore, |
||||
FT_ULong table_len ); |
||||
|
||||
typedef FT_Error |
||||
(*FT_Var_Load_Item_Var_Store_Func)( FT_Face face, |
||||
FT_ULong offset, |
||||
GX_ItemVarStore itemStore ); |
||||
|
||||
typedef FT_ItemVarDelta |
||||
(*FT_Var_Get_Item_Delta_Func)( FT_Face face, |
||||
GX_ItemVarStore itemStore, |
||||
FT_UInt outerIndex, |
||||
FT_UInt innerIndex ); |
||||
|
||||
typedef void |
||||
(*FT_Var_Done_Item_Var_Store_Func)( FT_Face face, |
||||
GX_ItemVarStore itemStore ); |
||||
|
||||
typedef void |
||||
(*FT_Var_Done_Delta_Set_Idx_Map_Func)( FT_Face face, |
||||
GX_DeltaSetIdxMap deltaSetIdxMap ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( MultiMasters ) |
||||
{ |
||||
FT_Get_MM_Func get_mm; |
||||
FT_Set_MM_Design_Func set_mm_design; |
||||
FT_Set_MM_Blend_Func set_mm_blend; |
||||
FT_Get_MM_Blend_Func get_mm_blend; |
||||
FT_Get_MM_Var_Func get_mm_var; |
||||
FT_Set_Var_Design_Func set_var_design; |
||||
FT_Get_Var_Design_Func get_var_design; |
||||
FT_Set_Named_Instance_Func set_named_instance; |
||||
FT_Get_Default_Named_Instance_Func get_default_named_instance; |
||||
FT_Set_MM_WeightVector_Func set_mm_weightvector; |
||||
FT_Get_MM_WeightVector_Func get_mm_weightvector; |
||||
|
||||
/* for internal use; only needed for code sharing between modules */ |
||||
FT_Construct_PS_Name_Func construct_ps_name; |
||||
FT_Var_Load_Delta_Set_Idx_Map_Func load_delta_set_idx_map; |
||||
FT_Var_Load_Item_Var_Store_Func load_item_var_store; |
||||
FT_Var_Get_Item_Delta_Func get_item_delta; |
||||
FT_Var_Done_Item_Var_Store_Func done_item_var_store; |
||||
FT_Var_Done_Delta_Set_Idx_Map_Func done_delta_set_idx_map; |
||||
FT_Get_Var_Blend_Func get_var_blend; |
||||
FT_Done_Blend_Func done_blend; |
||||
}; |
||||
|
||||
|
||||
#define FT_DEFINE_SERVICE_MULTIMASTERSREC( class_, \ |
||||
get_mm_, \
|
||||
set_mm_design_, \
|
||||
set_mm_blend_, \
|
||||
get_mm_blend_, \
|
||||
get_mm_var_, \
|
||||
set_var_design_, \
|
||||
get_var_design_, \
|
||||
set_named_instance_, \
|
||||
get_default_named_instance_, \
|
||||
set_mm_weightvector_, \
|
||||
get_mm_weightvector_, \
|
||||
\
|
||||
construct_ps_name_, \
|
||||
load_delta_set_idx_map_, \
|
||||
load_item_var_store_, \
|
||||
get_item_delta_, \
|
||||
done_item_var_store_, \
|
||||
done_delta_set_idx_map_, \
|
||||
get_var_blend_, \
|
||||
done_blend_ ) \
|
||||
static const FT_Service_MultiMastersRec class_ = \
|
||||
{ \
|
||||
get_mm_, \
|
||||
set_mm_design_, \
|
||||
set_mm_blend_, \
|
||||
get_mm_blend_, \
|
||||
get_mm_var_, \
|
||||
set_var_design_, \
|
||||
get_var_design_, \
|
||||
set_named_instance_, \
|
||||
get_default_named_instance_, \
|
||||
set_mm_weightvector_, \
|
||||
get_mm_weightvector_, \
|
||||
\
|
||||
construct_ps_name_, \
|
||||
load_delta_set_idx_map_, \
|
||||
load_item_var_store_, \
|
||||
get_item_delta_, \
|
||||
done_item_var_store_, \
|
||||
done_delta_set_idx_map_, \
|
||||
get_var_blend_, \
|
||||
done_blend_ \
|
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* SVMM_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
@ -0,0 +1,55 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* svotval.h |
||||
* |
||||
* The FreeType OpenType validation service (specification). |
||||
* |
||||
* Copyright (C) 2004-2023 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. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#ifndef SVOTVAL_H_ |
||||
#define SVOTVAL_H_ |
||||
|
||||
#include <freetype/ftotval.h> |
||||
#include <freetype/internal/ftvalid.h> |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
#define FT_SERVICE_ID_OPENTYPE_VALIDATE "opentype-validate" |
||||
|
||||
|
||||
typedef FT_Error |
||||
(*otv_validate_func)( FT_Face volatile face, |
||||
FT_UInt ot_flags, |
||||
FT_Bytes *base, |
||||
FT_Bytes *gdef, |
||||
FT_Bytes *gpos, |
||||
FT_Bytes *gsub, |
||||
FT_Bytes *jstf ); |
||||
|
||||
|
||||
FT_DEFINE_SERVICE( OTvalidate ) |
||||
{ |
||||
otv_validate_func validate; |
||||
}; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* SVOTVAL_H_ */ |
||||
|
||||
|
||||
/* END */ |
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue