Go to file
Ben Wagner f7daf9d293 [stream] Fix reading s32 when long is s64
`FT_READ_LONG`, `FT_GET_LONG`, and related macros did not return
negative values when `long` is more than 32 bits. `FT_Stream_ReadULong`
would read four bytes into the LSB of an `FT_ULong` and return that.
Since this can never set the MSb of the `FT_ULong` when `FT_ULong` is
more than 32 bits the cast to `FT_Long` never resulted in a negative
value.

Fix this by modifying `FT_Stream_Read*` to return a type of the same
size as the bytes it is reading and changing the `FT_READ_*` and
`FT_GET_*` macros to cast to the same type returned by `FT_Stream_Read*`
but with the correctly signed type (instead of casting to what is
assumed to be the type of `var` which will happen automatically anyway).

There exist a few cases like with the `OFF3` variants where there isn't
generally a type with the correct size. `FT_PEEK_OFF3` works around this
loading the bytes into the three most significant bits and then doing a
signed shift down. `FT_NEXT_OFF3` also already worked correctly by
casting this signed value to another signed type. `FT_Stream_GetUOffset`
works correctly but one must be careful not to attempt to cast the
returned value to a signed type. Fortunately there is only
`FT_GET_UOFF3` and no `FT_GET_OFF3`.

All of these cases are handled correctly when reading values through
`FT_Stream_ReadFields` since it generically computes the signed value
through an `FT_Int32`. This change is essentially doing the same for
these macros.

* include/freetype/internal/ftstream.h (FT_NEXT_*, FT_GET_*, FT_READ*):
Update macros and return types to use fixed size types for fixed size
values.

* src/base/ftstream.c (FT_StreamGet*, FT_StreamRead*): Dito.

Issue: #1161
2022-06-18 12:58:23 -04:00
builds * builds/toplevel.mk (do-dist): Don't remove meson wrap files. 2022-05-18 16:12:19 +02:00
devel Add flag `FT_CONFIG_OPTION_SVG`. 2022-01-20 16:45:18 +00:00
docs [docs] Correct favicon. 2022-05-31 22:40:55 -04:00
include [stream] Fix reading s32 when long is s64 2022-06-18 12:58:23 -04:00
objs * builds/windows/vc2010/freetype.vcxproj: AfterBuild copy. 2017-12-16 22:00:40 -05:00
src [stream] Fix reading s32 when long is s64 2022-06-18 12:58:23 -04:00
subprojects * subprojects/zlib.wrap: Update to zlib version 1.2.12. 2022-05-18 16:02:21 +02:00
tests * tests/issue-1063/main.c: s/PATH_MAX/FILENAME_MAX/. 2021-10-20 11:27:03 -04:00
.clang-format Add .clang-format file 2020-07-16 15:51:06 +02:00
.gitignore [meson] Add first regression test to FreeType 2021-06-16 10:28:47 +02:00
.gitlab-ci.yml [meson] Remove `default_library=both` from `default_options`. 2022-04-24 17:01:56 +02:00
.gitmodules Move 'dlg' submodule to `subprojects` directory. 2021-02-16 14:07:18 +01:00
.mailmap .mailmap: Typo. 2022-01-24 07:57:20 +01:00
CMakeLists.txt * Version 2.12.1 released. 2022-05-01 07:09:34 +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. 2022-01-11 10:54:10 +01:00
README REAMDE: Mention that gitlab's 'download' button doesn't work. 2022-05-18 07:06:58 +02:00
README.git Update all copyright notices. 2022-01-11 10:54:10 +01:00
autogen.sh autogen.sh: Fix building when freetype is itself a git submodule. 2022-04-26 16:07:42 -07:00
configure Update all copyright notices. 2022-01-11 10:54:10 +01:00
meson.build [meson] Remove `default_library=both` from `default_options`. 2022-04-24 17:01:56 +02:00
meson_options.txt Update all copyright notices. 2022-01-11 10:54:10 +01:00
modules.cfg Add 'svg' module for OT-SVG rendering. 2022-01-20 16:45:18 +00:00
vms_make.com Update all copyright notices. 2022-01-11 10:54:10 +01:00

README

FreeType 2.12.1
===============

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`.  Note that you have  to actually clone
the repository; using a snapshot will  not work (in other words, don't
use gitlab's 'Download' button).

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.12.1.tar.xz
  freetype-doc-2.12.1.tar.gz
  ftdoc2121.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-2022 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 ---