|
|
lua-discount 1.2.10 (Default branch)
09-04-2008
|
|
doc::lua-oocairo-fontopt(3) Lua OO Cairo binding doc::lua-oocairo-fontopt(3) Name lua-oocairo-fontopt - options controlling text rendering Introduction A font options object contains options that tell Cairo how to render text on surfaces. They can be created with the "font_options_create" function in the main oocairo module (see lua-oocairo(3)), and retrieved from scaled fonts or context objects with "get_font_options" methods. Font options objects can be compared with the "==" operator. Two different objects with the same options set will be considered equal. Methods The following methods are available on font options objects: opt:copy () Returns a new font options object, with identical options to opt. The two objects will be completely independent, so you can set them to have different options. opt:get_antialias () Get the current antialiasing mode, which will be one of the strings accepted by the "opt:set_antialias()" method. opt:get_hint_metrics () Returns the current hint metrics option, which will be one of the same strings accepted by the "opt:set_hint_metrics()" method. opt:get_hint_style () Get the kind of font hinting done when rendering text. Returns one of the strings accepted by the "opt:set_hint_style()" method. opt:get_subpixel_order () Returns the current ordering of colour components in pixels used for subpixel rendering, which will be one of the same strings accepted by the "opt:set_subpixel_order()" method. opt:hash () Return a number which can be used as a hash key identifying the particular options in opt. That is, if you wanted to cache fonts according to the options set on them, you could store them in a table with this hash value as the key. Two font options objects with the same options will have the same hash value. opt:merge (srcopt) Add any options which are set to a non-default value in srcopt to opt if that still has the default value from them. The options in srcopt will be unchanged. Nothing is returned. opt:set_antialias (antialiastype) Set the antialiasing mode used for drawing. The argument must be a string or boolean value accepted by the "set_antialias" method on context objects (see lua-oocairo-context(3)). opt:set_hint_metrics (hintmetrics) Set the kind of hinting to be applied to the metrics, as opposed to outlines, of the glyphs in a font. The hintmetrics value must be one of the following strings: default off on opt:set_hint_style (hintstyle) Set the kind of font hinting done when rendering text. The hintstyle value must be one of the following strings: default none slight medium full opt:set_subpixel_order (order) Used to inform Cairo of the arrangement of colour components in the pixels of a display device like a monitor. Only applies if subpixel antialiasing is used. The order value must be one of the following strings: default rgb bgr vrgb vbgr The last two options refer to vertical arrangements of colours. 1.4 2011-05-18 doc::lua-oocairo-fontopt(3)