Lines Matching full:the
7 * modify, merge, publish, distribute, sublicense, and/or sell copies of the
8 * Materials, and to permit persons to whom the Materials are furnished to do
9 * so, subject to the following conditions:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Materials.
15 * NEMAGFX API. THE UNMODIFIED, NORMATIVE VERSIONS OF THINK-SILICON NEMAGFX
19 * The software is provided 'as is', without warranty of any kind, express or
20 * implied, including but not limited to the warranties of merchantability,
24 * from, out of or in connection with the software or the use or other dealings
25 * in the software.
32 …* This file includes the necessary structs and functions that are used for rendering text (strings…
33 …* using vector fonts. The accompanying vector font converter utility, converts truetype fonts (ttf…
34 …* of the structs defined here. A use case of this module is included in the respective examples (e…
49 #define NEMA_VG_ALIGNX_LEFT (0x00U) /**< Align horizontally to the left */
50 #define NEMA_VG_ALIGNX_RIGHT (0x01U) /**< Align horizontally to the right */
54 #define NEMA_VG_ALIGNY_TOP (0x00U) /**< Align vertically to the top */
55 #define NEMA_VG_ALIGNY_BOTTOM (0x04U) /**< Align vertically to the bottom */
69 …const uint32_t left; /**< Neighbor character to the left of the current one (Unicode value) …
75 …const uint32_t data_offset; /**< Offset value for the data of the glyph in the respective data…
76 const size_t data_length; /**< Length of the data in the respective data array */
77 …const uint32_t segment_offset; /**< Offset value for the segments of the glyph in the respective …
78 const size_t segment_length; /**< Length of the segments in the respective segment array */
80 …const uint32_t kern_offset; /**< Kerning offset of the glyph in the respective kerning array …
81 const uint8_t kern_length; /**< Length of the kerning information of the glyph */
82 const int16_t bbox_xmin; /**< Minimum x of the glyph's bounding box */
83 const int16_t bbox_ymin; /**< Minimum y of the glyph's bounding box */
84 const int16_t bbox_xmax; /**< Maximum x of the glyph's bounding box */
85 const int16_t bbox_ymax; /**< Maximum y of the glyph's bounding box */
90 const uint32_t first; /**< Unicode value of the first value of the range */
91 const uint32_t last; /**< Unicode value of the last value of the range */
92 const nema_vg_glyph_t *glyphs; /**< Pointer to the array of glyphs */
98 const nema_vg_font_range_t *ranges; /**< Pointer to the array of ranges */
99 const nema_vg_float_t *data; /**< Pointer to the data of the vector font */
100 const size_t data_length; /**< Length of the vector font data*/
101 const uint8_t *segment; /**< Pointer to the segments of the vector font */
102 const size_t segment_length; /**< Length of the vector font segments */
104 … xAdvance; /**< Default advance width. If the space character is included in the ra…
105 … ascender; /**< Vertical distance from the baseline to the highest point of the f…
106 … descender; /**< Vertical distance from the baseline to the lowest point of the f…
107 …const nema_vg_kern_pair_t *kern_pairs; /**< Pointer to the array of the font's kerning pairs…
111 /** \brief Bind the font to use in future nema_vg_print() calls. Sets error code if font is not sup…
113 * \param font Pointer to the vector font
118 /** \brief Sets the size of the bound font. Future nema_vg_print() and nema_vg_print_char() calls w…
120 * \param font Pointer to the vector font
128 * \param paint Pointer to the current paint object (contains the text color)
141 /** \brief Get the bounding box's width and height of a vector string. Prior to calling this functi…
155 /** \brief Get the text ascender value in point units. Font size must be set pror to calling this f…
164 * \details The position of the character is determined by the 'orientation' argument.
165 * x and y arguments define a point on the baseline. If the orientation is left to right (LTR),
166 * the character will be placed to the right of the (x, y) point. Right to left (RTL) will place
167 * the character to the left of the (x, y) point. Top to bottom (TTB) will have the same effect as
168 * RTL and bottom to top (BTT) will place the character higher than the (x, y) point by an offset
169 * equal to the font height.
171 * \param paint Pointer to the current paint object (contains the text color)
173 …* \param x X coordinate of character's top-left or top-right corner (controlled by the 'orientatio…
174 …* \param y Y coordinate of character's top-left or bottom-left corner (controlled by the 'orientat…
184 …* \details Creates an 8-bpp raster version of the bound vector font. Performs dynamic memory alloc…
185 …* the graphics memory (for the font bitmaps) and in the heap (for the data structs accessed by the…
186 …* When the font is no longer needed, function "nema_vg_destroy_raster_font()" can be used to free …
187 …* memory. The font generation may fail when there is not enough memory to generate the font or whe…
188 * size is greater than the height of the framebuffer.
190 * \param size The size of the font that will be generated
191 * \param pool Memory pool to store the font bitmaps
192 …* \return Pointer to the data struct of generated raster font. If the font was not generated (due …
197 /** \brief Frees the memory that was allocated for a font data struct
200 * a font data struct that was generated by the "nema_vg_generate_raster_font" function.
202 * \param font Pointer to the raster font data struct that will be erased from the memory