#[repr(C)]pub struct QRawFont { /* private fields */ }
Expand description
The QRawFont class provides access to a single physical instance of a font.
C++ class: QRawFont
.
The QRawFont class provides access to a single physical instance of a font.
Note: QRawFont is a low level class. For most purposes QFont is a more appropriate class.
Most commonly, when presenting text in a user interface, the exact fonts used to render the characters is to some extent unknown. This can be the case for several reasons: For instance, the actual, physical fonts present on the target system could be unexpected to the developers, or the text could contain user selected styles, sizes or writing systems that are not supported by font chosen in the code.
Therefore, Qt's QFont class really represents a query for fonts. When text is interpreted, Qt will do its best to match the text to the query, but depending on the support, different fonts can be used behind the scenes.
For most use cases, this is both expected and necessary, as it minimizes the possibility of text in the user interface being undisplayable. In some cases, however, more direct control over the process might be useful. It is for these use cases the QRawFont class exists.
A QRawFont object represents a single, physical instance of a given font in a given pixel size. I.e. in the typical case it represents a set of TrueType or OpenType font tables and uses a user specified pixel size to convert metrics into logical pixel units. It can be used in combination with the QGlyphRun class to draw specific glyph indexes at specific positions, and also have accessors to some relevant data in the physical font.
QRawFont only provides support for the main font technologies: GDI and DirectWrite on Windows platforms, FreeType on Linux platforms and CoreText on macOS. For other font back-ends, the APIs will be disabled.
QRawFont can be constructed in a number of ways:
- It can be constructed by calling QTextLayout::glyphs() or QTextFragment::glyphs(). The returned QGlyphs objects will contain QRawFont objects which represent the actual fonts used to render each portion of the text.
- It can be constructed by passing a QFont object to QRawFont::fromFont(). The function will return a QRawFont object representing the font that will be selected as response to the QFont query and the selected writing system.
- It can be constructed by passing a file name or QByteArray directly to the QRawFont constructor, or by calling loadFromFile() or loadFromData(). In this case, the font will not be registered in QFontDatabase, and it will not be available as part of regular font selection.
QRawFont is considered local to the thread in which it is constructed (either using a constructor, or by calling loadFromData() or loadFromFile()). The QRawFont cannot be moved to a different thread, but will have to be recreated in the thread in question.
Note: For the requirement of caching glyph indexes and font selections for static text to avoid reshaping and relayouting in the inner loop of an application, a better choice is the QStaticText class, since it optimizes the memory cost of the cache and also provides the possibility of paint engine specific caches for an additional speed-up.
Implementations§
source§impl QRawFont
impl QRawFont
sourcepub unsafe fn advances_for_glyph_indexes_1a(
&self,
glyph_indexes: impl CastInto<Ref<QVectorOfU32>>
) -> CppBox<QVectorOfQPointF>
pub unsafe fn advances_for_glyph_indexes_1a( &self, glyph_indexes: impl CastInto<Ref<QVectorOfU32>> ) -> CppBox<QVectorOfQPointF>
This is an overloaded function.
Calls C++ function: QVector<QPointF> QRawFont::advancesForGlyphIndexes(const QVector<quint32>& glyphIndexes) const
.
This is an overloaded function.
Returns the QRawFont's advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. The advance of each glyph is calculated separately.
See also QTextLine::horizontalAdvance() and QFontMetricsF::width().
sourcepub unsafe fn advances_for_glyph_indexes_2a(
&self,
glyph_indexes: impl CastInto<Ref<QVectorOfU32>>,
layout_flags: QFlags<LayoutFlag>
) -> CppBox<QVectorOfQPointF>
pub unsafe fn advances_for_glyph_indexes_2a( &self, glyph_indexes: impl CastInto<Ref<QVectorOfU32>>, layout_flags: QFlags<LayoutFlag> ) -> CppBox<QVectorOfQPointF>
Returns the QRawFont's advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. How the advances are calculated is controlled by layoutFlags.
Calls C++ function: QVector<QPointF> QRawFont::advancesForGlyphIndexes(const QVector<quint32>& glyphIndexes, QFlags<QRawFont::LayoutFlag> layoutFlags) const
.
Returns the QRawFont’s advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. How the advances are calculated is controlled by layoutFlags.
This function was introduced in Qt 5.1.
See also QTextLine::horizontalAdvance() and QFontMetricsF::width().
sourcepub unsafe fn advances_for_glyph_indexes_3a(
&self,
glyph_indexes: *const u32,
advances: impl CastInto<Ptr<QPointF>>,
num_glyphs: c_int
) -> bool
pub unsafe fn advances_for_glyph_indexes_3a( &self, glyph_indexes: *const u32, advances: impl CastInto<Ptr<QPointF>>, num_glyphs: c_int ) -> bool
This is an overloaded function.
Calls C++ function: bool QRawFont::advancesForGlyphIndexes(const quint32* glyphIndexes, QPointF* advances, int numGlyphs) const
.
This is an overloaded function.
Returns the QRawFont's advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. The glyph indexes are given with the array glyphIndexes while the results are returned through advances, both of them must have numGlyphs elements. The advance of each glyph is calculated separately
See also QTextLine::horizontalAdvance() and QFontMetricsF::width().
sourcepub unsafe fn advances_for_glyph_indexes_4a(
&self,
glyph_indexes: *const u32,
advances: impl CastInto<Ptr<QPointF>>,
num_glyphs: c_int,
layout_flags: QFlags<LayoutFlag>
) -> bool
pub unsafe fn advances_for_glyph_indexes_4a( &self, glyph_indexes: *const u32, advances: impl CastInto<Ptr<QPointF>>, num_glyphs: c_int, layout_flags: QFlags<LayoutFlag> ) -> bool
Returns the QRawFont's advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. The glyph indexes are given with the array glyphIndexes while the results are returned through advances, both of them must have numGlyphs elements. How the advances are calculated is controlled by layoutFlags.
Calls C++ function: bool QRawFont::advancesForGlyphIndexes(const quint32* glyphIndexes, QPointF* advances, int numGlyphs, QFlags<QRawFont::LayoutFlag> layoutFlags) const
.
Returns the QRawFont’s advances for each of the glyphIndexes in pixel units. The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. The glyph indexes are given with the array glyphIndexes while the results are returned through advances, both of them must have numGlyphs elements. How the advances are calculated is controlled by layoutFlags.
This function was introduced in Qt 5.1.
See also QTextLine::horizontalAdvance() and QFontMetricsF::width().
sourcepub unsafe fn alpha_map_for_glyph_3a(
&self,
glyph_index: u32,
antialiasing_type: AntialiasingType,
transform: impl CastInto<Ref<QTransform>>
) -> CppBox<QImage>
pub unsafe fn alpha_map_for_glyph_3a( &self, glyph_index: u32, antialiasing_type: AntialiasingType, transform: impl CastInto<Ref<QTransform>> ) -> CppBox<QImage>
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
Calls C++ function: QImage QRawFont::alphaMapForGlyph(quint32 glyphIndex, QRawFont::AntialiasingType antialiasingType = …, const QTransform& transform = …) const
.
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
If the font is a color font, then the resulting image will contain the rendered glyph at the current pixel size. In this case, the antialiasingType will be ignored.
Otherwise, if antialiasingType is set to QRawFont::SubPixelAntialiasing, then the resulting image will be in QImage::Format_RGB32 and the RGB values of each pixel will represent the subpixel opacities of the pixel in the rasterization of the glyph. Otherwise, the image will be in the format of QImage::Format_Indexed8 and each pixel will contain the opacity of the pixel in the rasterization.
See also pathForGlyph() and QPainter::drawGlyphRun().
sourcepub unsafe fn alpha_map_for_glyph_2a(
&self,
glyph_index: u32,
antialiasing_type: AntialiasingType
) -> CppBox<QImage>
pub unsafe fn alpha_map_for_glyph_2a( &self, glyph_index: u32, antialiasing_type: AntialiasingType ) -> CppBox<QImage>
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
Calls C++ function: QImage QRawFont::alphaMapForGlyph(quint32 glyphIndex, QRawFont::AntialiasingType antialiasingType = …) const
.
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
If the font is a color font, then the resulting image will contain the rendered glyph at the current pixel size. In this case, the antialiasingType will be ignored.
Otherwise, if antialiasingType is set to QRawFont::SubPixelAntialiasing, then the resulting image will be in QImage::Format_RGB32 and the RGB values of each pixel will represent the subpixel opacities of the pixel in the rasterization of the glyph. Otherwise, the image will be in the format of QImage::Format_Indexed8 and each pixel will contain the opacity of the pixel in the rasterization.
See also pathForGlyph() and QPainter::drawGlyphRun().
sourcepub unsafe fn alpha_map_for_glyph_1a(&self, glyph_index: u32) -> CppBox<QImage>
pub unsafe fn alpha_map_for_glyph_1a(&self, glyph_index: u32) -> CppBox<QImage>
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
Calls C++ function: QImage QRawFont::alphaMapForGlyph(quint32 glyphIndex) const
.
This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. If the QRawFont is not valid, this function will return an invalid QImage.
If the font is a color font, then the resulting image will contain the rendered glyph at the current pixel size. In this case, the antialiasingType will be ignored.
Otherwise, if antialiasingType is set to QRawFont::SubPixelAntialiasing, then the resulting image will be in QImage::Format_RGB32 and the RGB values of each pixel will represent the subpixel opacities of the pixel in the rasterization of the glyph. Otherwise, the image will be in the format of QImage::Format_Indexed8 and each pixel will contain the opacity of the pixel in the rasterization.
See also pathForGlyph() and QPainter::drawGlyphRun().
sourcepub unsafe fn ascent(&self) -> c_double
pub unsafe fn ascent(&self) -> c_double
Returns the ascent of this QRawFont in pixel units.
Calls C++ function: double QRawFont::ascent() const
.
Returns the ascent of this QRawFont in pixel units.
The ascent of a font is the distance from the baseline to the highest position characters extend to. In practice, some font designers break this rule, e.g. when they put more than one accent on top of a character, or to accommodate an unusual character in an exotic language, so it is possible (though rare) that this value will be too small.
See also QFontMetricsF::ascent().
sourcepub unsafe fn average_char_width(&self) -> c_double
pub unsafe fn average_char_width(&self) -> c_double
Returns the average character width of this QRawFont in pixel units.
Calls C++ function: double QRawFont::averageCharWidth() const
.
Returns the average character width of this QRawFont in pixel units.
See also QFontMetricsF::averageCharWidth().
sourcepub unsafe fn bounding_rect(&self, glyph_index: u32) -> CppBox<QRectF>
pub unsafe fn bounding_rect(&self, glyph_index: u32) -> CppBox<QRectF>
Returns the smallest rectangle containing the glyph with the given glyphIndex.
Calls C++ function: QRectF QRawFont::boundingRect(quint32 glyphIndex) const
.
Returns the smallest rectangle containing the glyph with the given glyphIndex.
This function was introduced in Qt 5.0.
sourcepub unsafe fn cap_height(&self) -> c_double
pub unsafe fn cap_height(&self) -> c_double
Returns the cap height of this QRawFont in pixel units.
Calls C++ function: double QRawFont::capHeight() const
.
Returns the cap height of this QRawFont in pixel units.
The cap height of a font is the height of a capital letter above the baseline. It specifically is the height of capital letters that are flat - such as H or I - as opposed to round letters such as O, or pointed letters like A, both of which may display overshoot.
This function was introduced in Qt 5.8.
See also QFontMetricsF::capHeight().
sourcepub unsafe fn copy_from(
&self,
other: impl CastInto<Ref<QRawFont>>
) -> Ref<QRawFont>
pub unsafe fn copy_from( &self, other: impl CastInto<Ref<QRawFont>> ) -> Ref<QRawFont>
sourcepub unsafe fn descent(&self) -> c_double
pub unsafe fn descent(&self) -> c_double
Returns the descent of this QRawFont in pixel units.
Calls C++ function: double QRawFont::descent() const
.
Returns the descent of this QRawFont in pixel units.
The descent is the distance from the base line to the lowest point characters extend to. In practice, some font designers break this rule, e.g. to accommodate an unusual character in an exotic language, so it is possible (though rare) that this value will be too small.
See also QFontMetricsF::descent().
sourcepub unsafe fn family_name(&self) -> CppBox<QString>
pub unsafe fn family_name(&self) -> CppBox<QString>
sourcepub unsafe fn font_table(&self, tag_name: *const c_char) -> CppBox<QByteArray>
pub unsafe fn font_table(&self, tag_name: *const c_char) -> CppBox<QByteArray>
Retrieves the sfnt table named tagName from the underlying physical font, or an empty byte array if no such table was found. The returned font table's byte order is Big Endian, like the sfnt format specifies. The tagName must be four characters long and should be formatted in the default endianness of the current platform.
Calls C++ function: QByteArray QRawFont::fontTable(const char* tagName) const
.
Retrieves the sfnt table named tagName from the underlying physical font, or an empty byte array if no such table was found. The returned font table’s byte order is Big Endian, like the sfnt format specifies. The tagName must be four characters long and should be formatted in the default endianness of the current platform.
sourcepub unsafe fn from_font_2a(
font: impl CastInto<Ref<QFont>>,
writing_system: WritingSystem
) -> CppBox<QRawFont>
pub unsafe fn from_font_2a( font: impl CastInto<Ref<QFont>>, writing_system: WritingSystem ) -> CppBox<QRawFont>
Fetches the physical representation based on a font query. The physical font returned is the font that will be preferred by Qt in order to display text in the selected writingSystem.
Calls C++ function: static QRawFont QRawFont::fromFont(const QFont& font, QFontDatabase::WritingSystem writingSystem = …)
.
Fetches the physical representation based on a font query. The physical font returned is the font that will be preferred by Qt in order to display text in the selected writingSystem.
Warning: This function is potentially expensive and should not be called in performance sensitive code.
sourcepub unsafe fn from_font_1a(font: impl CastInto<Ref<QFont>>) -> CppBox<QRawFont>
pub unsafe fn from_font_1a(font: impl CastInto<Ref<QFont>>) -> CppBox<QRawFont>
Fetches the physical representation based on a font query. The physical font returned is the font that will be preferred by Qt in order to display text in the selected writingSystem.
Calls C++ function: static QRawFont QRawFont::fromFont(const QFont& font)
.
Fetches the physical representation based on a font query. The physical font returned is the font that will be preferred by Qt in order to display text in the selected writingSystem.
Warning: This function is potentially expensive and should not be called in performance sensitive code.
sourcepub unsafe fn glyph_indexes_for_chars(
&self,
chars: impl CastInto<Ptr<QChar>>,
num_chars: c_int,
glyph_indexes: *mut u32,
num_glyphs: *mut c_int
) -> bool
pub unsafe fn glyph_indexes_for_chars( &self, chars: impl CastInto<Ptr<QChar>>, num_chars: c_int, glyph_indexes: *mut u32, num_glyphs: *mut c_int ) -> bool
Converts a string of unicode points to glyph indexes using the CMAP table in the underlying font. The function works like glyphIndexesForString() except it take an array (chars), the results will be returned though glyphIndexes array and number of glyphs will be set in numGlyphs. The size of glyphIndexes array must be at least numChars, if that's still not enough, this function will return false, then you can resize glyphIndexes from the size returned in numGlyphs.
Calls C++ function: bool QRawFont::glyphIndexesForChars(const QChar* chars, int numChars, quint32* glyphIndexes, int* numGlyphs) const
.
Converts a string of unicode points to glyph indexes using the CMAP table in the underlying font. The function works like glyphIndexesForString() except it take an array (chars), the results will be returned though glyphIndexes array and number of glyphs will be set in numGlyphs. The size of glyphIndexes array must be at least numChars, if that’s still not enough, this function will return false, then you can resize glyphIndexes from the size returned in numGlyphs.
See also glyphIndexesForString(), advancesForGlyphIndexes(), QGlyphRun, QTextLayout::glyphRuns(), and QTextFragment::glyphRuns().
sourcepub unsafe fn glyph_indexes_for_string(
&self,
text: impl CastInto<Ref<QString>>
) -> CppBox<QVectorOfU32>
pub unsafe fn glyph_indexes_for_string( &self, text: impl CastInto<Ref<QString>> ) -> CppBox<QVectorOfU32>
Converts the string of unicode points given by text to glyph indexes using the CMAP table in the underlying font, and returns a vector containing the result.
Calls C++ function: QVector<quint32> QRawFont::glyphIndexesForString(const QString& text) const
.
Converts the string of unicode points given by text to glyph indexes using the CMAP table in the underlying font, and returns a vector containing the result.
Note that, in cases where there are other tables in the font that affect the shaping of the text, the returned glyph indexes will not correctly represent the rendering of the text. To get the correctly shaped text, you can use QTextLayout to lay out and shape the text, then call QTextLayout::glyphs() to get the set of glyph index list and QRawFont pairs.
See also advancesForGlyphIndexes(), glyphIndexesForChars(), QGlyphRun, QTextLayout::glyphRuns(), and QTextFragment::glyphRuns().
sourcepub unsafe fn hinting_preference(&self) -> HintingPreference
pub unsafe fn hinting_preference(&self) -> HintingPreference
Returns the hinting preference used to construct this QRawFont.
Calls C++ function: QFont::HintingPreference QRawFont::hintingPreference() const
.
Returns the hinting preference used to construct this QRawFont.
See also QFont::hintingPreference().
sourcepub unsafe fn is_valid(&self) -> bool
pub unsafe fn is_valid(&self) -> bool
sourcepub unsafe fn leading(&self) -> c_double
pub unsafe fn leading(&self) -> c_double
Returns the leading of this QRawFont in pixel units.
Calls C++ function: double QRawFont::leading() const
.
Returns the leading of this QRawFont in pixel units.
This is the natural inter-line spacing.
See also QFontMetricsF::leading().
sourcepub unsafe fn line_thickness(&self) -> c_double
pub unsafe fn line_thickness(&self) -> c_double
Returns the thickness for drawing lines (underline, overline, etc.) along with text drawn in this font.
Calls C++ function: double QRawFont::lineThickness() const
.
Returns the thickness for drawing lines (underline, overline, etc.) along with text drawn in this font.
sourcepub unsafe fn load_from_data(
&self,
font_data: impl CastInto<Ref<QByteArray>>,
pixel_size: c_double,
hinting_preference: HintingPreference
)
pub unsafe fn load_from_data( &self, font_data: impl CastInto<Ref<QByteArray>>, pixel_size: c_double, hinting_preference: HintingPreference )
Replaces the current QRawFont with the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: void QRawFont::loadFromData(const QByteArray& fontData, double pixelSize, QFont::HintingPreference hintingPreference)
.
Replaces the current QRawFont with the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
The fontData must contain a TrueType or OpenType font.
See also loadFromFile().
sourcepub unsafe fn load_from_file(
&self,
file_name: impl CastInto<Ref<QString>>,
pixel_size: c_double,
hinting_preference: HintingPreference
)
pub unsafe fn load_from_file( &self, file_name: impl CastInto<Ref<QString>>, pixel_size: c_double, hinting_preference: HintingPreference )
Replaces the current QRawFont with the contents of the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: void QRawFont::loadFromFile(const QString& fileName, double pixelSize, QFont::HintingPreference hintingPreference)
.
Replaces the current QRawFont with the contents of the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
The file must reference a TrueType or OpenType font.
See also loadFromData().
sourcepub unsafe fn max_char_width(&self) -> c_double
pub unsafe fn max_char_width(&self) -> c_double
Returns the width of the widest character in the font.
Calls C++ function: double QRawFont::maxCharWidth() const
.
Returns the width of the widest character in the font.
See also QFontMetricsF::maxWidth().
sourcepub unsafe fn new() -> CppBox<QRawFont>
pub unsafe fn new() -> CppBox<QRawFont>
sourcepub unsafe fn from_q_string_double_hinting_preference(
file_name: impl CastInto<Ref<QString>>,
pixel_size: c_double,
hinting_preference: HintingPreference
) -> CppBox<QRawFont>
pub unsafe fn from_q_string_double_hinting_preference( file_name: impl CastInto<Ref<QString>>, pixel_size: c_double, hinting_preference: HintingPreference ) -> CppBox<QRawFont>
Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: [constructor] void QRawFont::QRawFont(const QString& fileName, double pixelSize, QFont::HintingPreference hintingPreference = …)
.
Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Note: The referenced file must contain a TrueType or OpenType font.
sourcepub unsafe fn from_q_byte_array_double_hinting_preference(
font_data: impl CastInto<Ref<QByteArray>>,
pixel_size: c_double,
hinting_preference: HintingPreference
) -> CppBox<QRawFont>
pub unsafe fn from_q_byte_array_double_hinting_preference( font_data: impl CastInto<Ref<QByteArray>>, pixel_size: c_double, hinting_preference: HintingPreference ) -> CppBox<QRawFont>
Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: [constructor] void QRawFont::QRawFont(const QByteArray& fontData, double pixelSize, QFont::HintingPreference hintingPreference = …)
.
Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Note: The data must contain a TrueType or OpenType font.
sourcepub unsafe fn from_q_string_double(
file_name: impl CastInto<Ref<QString>>,
pixel_size: c_double
) -> CppBox<QRawFont>
pub unsafe fn from_q_string_double( file_name: impl CastInto<Ref<QString>>, pixel_size: c_double ) -> CppBox<QRawFont>
Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: [constructor] void QRawFont::QRawFont(const QString& fileName, double pixelSize)
.
Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Note: The referenced file must contain a TrueType or OpenType font.
sourcepub unsafe fn from_q_byte_array_double(
font_data: impl CastInto<Ref<QByteArray>>,
pixel_size: c_double
) -> CppBox<QRawFont>
pub unsafe fn from_q_byte_array_double( font_data: impl CastInto<Ref<QByteArray>>, pixel_size: c_double ) -> CppBox<QRawFont>
Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Calls C++ function: [constructor] void QRawFont::QRawFont(const QByteArray& fontData, double pixelSize)
.
Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.
Note: The data must contain a TrueType or OpenType font.
sourcepub unsafe fn new_copy(other: impl CastInto<Ref<QRawFont>>) -> CppBox<QRawFont>
pub unsafe fn new_copy(other: impl CastInto<Ref<QRawFont>>) -> CppBox<QRawFont>
sourcepub unsafe fn path_for_glyph(&self, glyph_index: u32) -> CppBox<QPainterPath>
pub unsafe fn path_for_glyph(&self, glyph_index: u32) -> CppBox<QPainterPath>
This function returns the shape of the glyph at a given glyphIndex in the underlying font if the QRawFont is valid. Otherwise, it returns an empty QPainterPath.
Calls C++ function: QPainterPath QRawFont::pathForGlyph(quint32 glyphIndex) const
.
This function returns the shape of the glyph at a given glyphIndex in the underlying font if the QRawFont is valid. Otherwise, it returns an empty QPainterPath.
The returned glyph will always be unhinted.
See also alphaMapForGlyph() and QPainterPath::addText().
sourcepub unsafe fn pixel_size(&self) -> c_double
pub unsafe fn pixel_size(&self) -> c_double
Returns the pixel size set for this QRawFont. The pixel size affects how glyphs are rasterized, the size of glyphs returned by pathForGlyph(), and is used to convert internal metrics from design units to logical pixel units.
Calls C++ function: double QRawFont::pixelSize() const
.
Returns the pixel size set for this QRawFont. The pixel size affects how glyphs are rasterized, the size of glyphs returned by pathForGlyph(), and is used to convert internal metrics from design units to logical pixel units.
See also setPixelSize().
sourcepub unsafe fn set_pixel_size(&self, pixel_size: c_double)
pub unsafe fn set_pixel_size(&self, pixel_size: c_double)
Sets the pixel size with which this font should be rendered to pixelSize.
Calls C++ function: void QRawFont::setPixelSize(double pixelSize)
.
Sets the pixel size with which this font should be rendered to pixelSize.
See also pixelSize().
sourcepub unsafe fn style(&self) -> Style
pub unsafe fn style(&self) -> Style
Returns the style of this QRawFont.
Calls C++ function: QFont::Style QRawFont::style() const
.
Returns the style of this QRawFont.
See also QFont::style().
sourcepub unsafe fn style_name(&self) -> CppBox<QString>
pub unsafe fn style_name(&self) -> CppBox<QString>
Returns the style name of this QRawFont.
Calls C++ function: QString QRawFont::styleName() const
.
Returns the style name of this QRawFont.
See also QFont::styleName().
sourcepub unsafe fn supported_writing_systems(&self) -> CppBox<QListOfWritingSystem>
pub unsafe fn supported_writing_systems(&self) -> CppBox<QListOfWritingSystem>
Returns a list of writing systems supported by the font according to designer supplied information in the font file. Please note that this does not guarantee support for a specific unicode point in the font. You can use the supportsCharacter() to check support for a single, specific character.
Calls C++ function: QList<QFontDatabase::WritingSystem> QRawFont::supportedWritingSystems() const
.
Returns a list of writing systems supported by the font according to designer supplied information in the font file. Please note that this does not guarantee support for a specific unicode point in the font. You can use the supportsCharacter() to check support for a single, specific character.
Note: The list is determined based on the unicode ranges and codepage ranges set in the font's OS/2 table and requires such a table to be present in the underlying font file.
See also supportsCharacter().
sourcepub unsafe fn supports_character_uint(&self, ucs4: c_uint) -> bool
pub unsafe fn supports_character_uint(&self, ucs4: c_uint) -> bool
This is an overloaded function.
Calls C++ function: bool QRawFont::supportsCharacter(unsigned int ucs4) const
.
This is an overloaded function.
Returns true
if the font has a glyph that corresponds to the UCS-4 encoded character ucs4.
See also supportedWritingSystems().
sourcepub unsafe fn supports_character_q_char(
&self,
character: impl CastInto<Ref<QChar>>
) -> bool
pub unsafe fn supports_character_q_char( &self, character: impl CastInto<Ref<QChar>> ) -> bool
Returns true
if the font has a glyph that corresponds to the given character.
Calls C++ function: bool QRawFont::supportsCharacter(QChar character) const
.
Returns true
if the font has a glyph that corresponds to the given character.
See also supportedWritingSystems().
sourcepub unsafe fn swap(&self, other: impl CastInto<Ref<QRawFont>>)
pub unsafe fn swap(&self, other: impl CastInto<Ref<QRawFont>>)
Swaps this raw font with other. This function is very fast and never fails.
Calls C++ function: void QRawFont::swap(QRawFont& other)
.
Swaps this raw font with other. This function is very fast and never fails.
This function was introduced in Qt 5.0.
sourcepub unsafe fn underline_position(&self) -> c_double
pub unsafe fn underline_position(&self) -> c_double
Returns the position from baseline for drawing underlines below the text rendered with this font.
Calls C++ function: double QRawFont::underlinePosition() const
.
Returns the position from baseline for drawing underlines below the text rendered with this font.
sourcepub unsafe fn units_per_em(&self) -> c_double
pub unsafe fn units_per_em(&self) -> c_double
Returns the number of design units define the width and height of the em square for this QRawFont. This value is used together with the pixel size when converting design metrics to pixel units, as the internal metrics are specified in design units and the pixel size gives the size of 1 em in pixels.
Calls C++ function: double QRawFont::unitsPerEm() const
.
Returns the number of design units define the width and height of the em square for this QRawFont. This value is used together with the pixel size when converting design metrics to pixel units, as the internal metrics are specified in design units and the pixel size gives the size of 1 em in pixels.
See also pixelSize() and setPixelSize().
sourcepub unsafe fn weight(&self) -> c_int
pub unsafe fn weight(&self) -> c_int
Returns the weight of this QRawFont.
Calls C++ function: int QRawFont::weight() const
.
Returns the weight of this QRawFont.
See also QFont::weight().
sourcepub unsafe fn x_height(&self) -> c_double
pub unsafe fn x_height(&self) -> c_double
Returns the xHeight of this QRawFont in pixel units.
Calls C++ function: double QRawFont::xHeight() const
.
Returns the xHeight of this QRawFont in pixel units.
This is often but not always the same as the height of the character 'x'.
See also QFontMetricsF::xHeight().