1/*
2 * Copyright 2014 Google Inc.
3 *
4 * Use of this source code is governed by a BSD-style license that can be
5 * found in the LICENSE file.
6 */
7#ifndef SkDistanceFieldGen_DEFINED
8#define SkDistanceFieldGen_DEFINED
9
10#include "include/core/SkTypes.h"
11
12// the max magnitude for the distance field
13// distance values are limited to the range (-SK_DistanceFieldMagnitude, SK_DistanceFieldMagnitude]
14#define SK_DistanceFieldMagnitude 4
15// we need to pad around the original glyph to allow our maximum distance of
16// SK_DistanceFieldMagnitude texels away from any edge
17#define SK_DistanceFieldPad 4
18// the rect we render with is inset from the distance field glyph size to allow for bilerp
19#define SK_DistanceFieldInset 2
20
21// For the fragment shader:
22// The distance field is constructed as unsigned char values,
23// so that the zero value is at 128, and the supported range of distances is [-4 * 127/128, 4].
24// Hence our multiplier (width of the range) is 4 * 255/128 and zero threshold is 128/255.
25#define SK_DistanceFieldMultiplier "7.96875"
26#define SK_DistanceFieldThreshold "0.50196078431"
27
28/** Given 8-bit mask data, generate the associated distance field
29
30 * @param distanceField The distance field to be generated. Should already be allocated
31 * by the client with the padding above.
32 * @param image 8-bit mask we're using to generate the distance field.
33 * @param w Width of the original image.
34 * @param h Height of the original image.
35 * @param rowBytes Size of each row in the image, in bytes
36 */
37bool SkGenerateDistanceFieldFromA8Image(unsigned char* distanceField,
38 const unsigned char* image,
39 int w, int h, size_t rowBytes);
40
41/** Given LCD16 mask data (not a 16-bit image), generate the associated distance field
42
43 * @param distanceField The distance field to be generated. Should already be allocated
44 * by the client with the padding above.
45 * @param image 16-bit LCD data we're using to generate the distance field.
46 * @param w Width of the original image.
47 * @param h Height of the original image.
48 * @param rowBytes Size of each row in the image, in bytes
49 */
50bool SkGenerateDistanceFieldFromLCD16Mask(unsigned char* distanceField,
51 const unsigned char* image,
52 int w, int h, size_t rowBytes);
53
54/** Given 1-bit mask data, generate the associated distance field
55
56 * @param distanceField The distance field to be generated. Should already be allocated
57 * by the client with the padding above.
58 * @param image 1-bit mask we're using to generate the distance field.
59 * @param w Width of the original image.
60 * @param h Height of the original image.
61 * @param rowBytes Size of each row in the image, in bytes
62 */
63bool SkGenerateDistanceFieldFromBWImage(unsigned char* distanceField,
64 const unsigned char* image,
65 int w, int h, size_t rowBytes);
66
67/** Given width and height of original image, return size (in bytes) of distance field
68 * @param w Width of the original image.
69 * @param h Height of the original image.
70 */
71inline size_t SkComputeDistanceFieldSize(int w, int h) {
72 return (w + 2*SK_DistanceFieldPad) * (h + 2*SK_DistanceFieldPad) * sizeof(unsigned char);
73}
74
75#endif
76