Go to file
Ben Wagner 369d8be97f [truetype] Prevent glyph program state from persisting.
`FDEF` instructions are specified as allowed only in 'prep' or
'fpgm'.  FreeType has attempted to prevent their use in the glyph
program, but they were still allowed in glyph programs if defined in
a function defined in 'prep' or 'fpgm' and called from the glyph
program.

Similarly, `IDEF` instructions are specified not to be able to
modify any existing instruction.  FreeType has attempted to prevent
their use in the glyph program, but they can still be used like
`FDEF`.

This change stores the initial bytecode range type and disallows the
use of `FDEF` and `IDEF` while running the glyph program.

Most other state is copied from the `TT_Size` into the execution
context.  However, it is possible for a glyph program to use `WS` to
write to the storage area or `WCVTP`, `WCVTF`, and `DELTAC[123]` to
write to the control value table.

Allowing any change to the global state from the glyph program is
problematic as the outlines of any given glyph may change based on
the order the glyphs are loaded or even how many times they are
loaded.  There exist fonts that write to the storage area or the
control value table in the glyph program, so their use should not be
an error.

Possible solutions to using these in the glyph program are

  * ignore the writes;
  * value-level copy on write, discard modified values when finished;
  * array-level copy on write, discard the copy when finished;
  * array-level copy up-front.

Ignoring the writes may break otherwise good uses.  A full copy
up-front was implemented, but was quite heavy as even well behaved
fonts required a full copy and the memory management that goes along
with it.  Value-level copy on write could use less memory but
requires a great deal more record keeping and complexity.  This
change implements array-level copy on write.  If any attempt is made
to write to the control value table or the storage area when the
initial bytecode range was in a glyph program, the relevant array
will be copied to a designated storage area and the copy used for
the rest of the glyph program's execution.

* src/truetype/ttinterp.h (TT_ExecContextRec): New fields
`iniRange`, `glyfCvtSize`, `glyfCvt`, `origCvt`, `glyfStoreSize`,
`glyfStorage`, and `origStorage`.

* src/truetype/ttinterp.c (Modify_CVT_Check): New function to handle
`exc->glyfCvt`.
(Write_CVT, Write_CVT_Stretched, Move_CVT, Move_CVT_Stretched): Use
it.
(Ins_WS): Handle `exc->glyfStorage`.
(Ins_FDEF, Ins_IDEF): Updated.
(TT_RunIns): Updated.
(TT_Done_Context): Free 'glyf' CVT working and storage area.
(TT_Load_Context): Fix/add casts.

* src/truetype/ttgload.c (TT_Load_Simple_Glyph): Fix cast.
2021-04-02 10:31:39 +02:00
builds * builds/unix/ax_pthread.m4: Update from 'autoconf-archive'. 2021-02-19 20:33:50 +01:00
devel Update all copyright notices. 2021-01-17 07:18:48 +01:00
docs [docs] Update docwriter stylesheet for 1.3.1. 2021-03-28 15:07:05 +05:30
include freetype.h: Documentation typos. 2021-02-27 12:14:02 +01:00
objs * builds/windows/vc2010/freetype.vcxproj: AfterBuild copy. 2017-12-16 22:00:40 -05:00
src [truetype] Prevent glyph program state from persisting. 2021-04-02 10:31:39 +02:00
subprojects [meson] Add subproject fallbacks for 'libpng' and 'zlib'. 2021-03-07 17:54:21 +01:00
.clang-format Add .clang-format file 2020-07-16 15:51:06 +02:00
.gitattributes .gitattributes: New file. 2021-01-16 09:13:44 +01:00
.gitignore [builds] Revert `FTMODULE_H' changes. 2021-01-08 13:22:34 -05:00
.gitlab-ci.yml [ci] Add basic support for Meson builds with MSVC on Windows. 2021-03-07 18:01:31 +01:00
.gitmodules Move 'dlg' submodule to `subprojects` directory. 2021-02-16 14:07:18 +01:00
.mailmap .mailmap: Updated and synchronized with 'freetype2-demos' repository. 2020-12-24 08:43:55 +01:00
CMakeLists.txt * CMakeLists.txt: Don't limit generation of 'pkg-config' file to UNIX. 2021-03-16 08:36:54 +01:00
ChangeLog [truetype] Prevent glyph program state from persisting. 2021-04-02 10:31:39 +02:00
LICENSE.TXT LICENSE.TXT: Moved to root directory; minor edits. 2021-01-22 09:07:51 +01:00
Makefile Update all copyright notices. 2021-01-17 07:18:48 +01:00
README Improve build documentation. 2021-02-27 11:02:53 +01:00
README.git README.git: Document cloning of official site and Savannah mirror. 2021-03-16 06:59:01 +01:00
autogen.sh Move 'dlg' submodule to `subprojects` directory. 2021-02-16 14:07:18 +01:00
configure Update all copyright notices. 2021-01-17 07:18:48 +01:00
meson.build meson.build: Minor formatting. 2021-03-08 10:30:57 +01:00
meson_options.txt Meson: Fix dependency lookup and generate ftconfig.h 2021-02-09 16:11:39 +01:00
modules.cfg Update all copyright notices. 2021-01-17 07:18:48 +01:00
vms_make.com Update all copyright notices. 2021-01-17 07:18:48 +01:00

README

FreeType 2.10.4
===============

Homepage: https://www.freetype.org

FreeType is a freely available software library to render fonts.

It  is  written  in  C,   designed  to  be  small,  efficient,  highly
customizable,  and portable  while capable  of producing  high-quality
output (glyph images) of most vector and bitmap font formats.

Please   read  the   `docs/CHANGES`   file,   it  contains   IMPORTANT
INFORMATION.

Read the files `docs/INSTALL*`  for installation instructions; see the
file `docs/LICENSE.TXT` for the available licenses.

For using FreeType's git repository  instead of a distribution bundle,
please read file `README.git`.

The FreeType 2 API reference is located in directory `docs/reference`;
use the file  `index.html` as the top entry point.   [Please note that
currently  the search  function  for  locally installed  documentation
doesn't work due to cross-site scripting issues.]

Additional documentation is  available as a separate  package from our
sites.  Go to

  https://download.savannah.gnu.org/releases/freetype/

and download one of the following files.

  freetype-doc-2.10.4.tar.xz
  freetype-doc-2.10.4.tar.gz
  ftdoc2104.zip

To view the documentation online, go to

  https://www.freetype.org/freetype2/docs/


Mailing Lists
-------------

The preferred  way of  communication with the  FreeType team  is using
e-mail lists.

  general use and discussion:      freetype@nongnu.org
  engine internals, porting, etc.: freetype-devel@nongnu.org
  announcements:                   freetype-announce@nongnu.org
  git repository tracker:          freetype-commit@nongnu.org

The lists are moderated; see

  https://www.freetype.org/contact.html

how to subscribe.


Bugs
----

Please submit bug reports at

  https://gitlab.freedesktop.org/freetype/freetype/-/issues

Alternatively,    you    might    report    bugs    by    e-mail    to
`freetype-devel@nongnu.org`.    Don't  forget   to  send   a  detailed
explanation of the problem -- there  is nothing worse than receiving a
terse message that only says 'it doesn't work'.


Patches
-------

For larger changes please provide merge requests at

  https://gitlab.freedesktop.org/freetype/freetype/-/merge_requests

Alternatively, you can send patches to the `freetype-devel@nongnu.org`
mailing list  -- and thank you  in advance for your  work on improving
FreeType!

Details on the process can be found here:

  https://www.freetype.org/developer.html#patches


Enjoy!


  The FreeType Team

----------------------------------------------------------------------

Copyright (C) 2006-2021 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.


--- end of README ---