1/* 2 * fontconfig/doc/fcweight.fncs 3 * 4 * Permission to use, copy, modify, distribute, and sell this software and its 5 * documentation for any purpose is hereby granted without fee, provided that 6 * the above copyright notice appear in all copies and that both that 7 * copyright notice and this permission notice appear in supporting 8 * documentation, and that the name of the author(s) not be used in 9 * advertising or publicity pertaining to distribution of the software without 10 * specific, written prior permission. The authors make no 11 * representations about the suitability of this software for any purpose. It 12 * is provided "as is" without express or implied warranty. 13 * 14 * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 15 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO 16 * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR 17 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, 18 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER 19 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 20 * PERFORMANCE OF THIS SOFTWARE. 21 */ 22@RET@ double 23@FUNC@ FcWeightFromOpenTypeDouble 24@TYPE1@ double @ARG1@ ot_weight 25@PURPOSE@ Convert from OpenType weight values to fontconfig ones 26@DESC@ 27<function>FcWeightFromOpenTypeDouble</function> returns an double value 28to use with FC_WEIGHT, from an double in the 1..1000 range, resembling 29the numbers from OpenType specification's OS/2 usWeight numbers, which 30are also similar to CSS font-weight numbers. If input is negative, 31zero, or greater than 1000, returns -1. This function linearly interpolates 32between various FC_WEIGHT_* constants. As such, the returned value does not 33necessarily match any of the predefined constants. 34@SINCE@ 2.12.92 35@@ 36 37@RET@ double 38@FUNC@ FcWeightToOpenTypeDouble 39@TYPE1@ double @ARG1@ ot_weight 40@PURPOSE@ Convert from fontconfig weight values to OpenType ones 41@DESC@ 42<function>FcWeightToOpenTypeDouble</function> is the inverse of 43<function>FcWeightFromOpenType</function>. If the input is less than 44FC_WEIGHT_THIN or greater than FC_WEIGHT_EXTRABLACK, returns -1. Otherwise 45returns a number in the range 1 to 1000. 46@SINCE@ 2.12.92 47@@ 48 49@RET@ int 50@FUNC@ FcWeightFromOpenType 51@TYPE1@ int @ARG1@ ot_weight 52@PURPOSE@ Convert from OpenType weight values to fontconfig ones 53@DESC@ 54<function>FcWeightFromOpenType</function> is like 55<function>FcWeightFromOpenTypeDouble</function> but with integer arguments. 56Use the other function instead. 57@SINCE@ 2.11.91 58@@ 59 60@RET@ int 61@FUNC@ FcWeightToOpenType 62@TYPE1@ int @ARG1@ ot_weight 63@PURPOSE@ Convert from fontconfig weight values to OpenType ones 64@DESC@ 65<function>FcWeightToOpenType</function> is like 66<function>FcWeightToOpenTypeDouble</function> but with integer arguments. 67Use the other function instead. 68@SINCE@ 2.11.91 69@@ 70