<!-- $XConsortium: SetFonUB.sgm /main/8 1996/09/08 21:02:09 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN397.rsml.1">
<RefMeta>
<RefEntryTitle>XmSetFontUnits</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmSetFontUnits</Function></RefName>
<RefPurpose>A function that sets the font unit value for a display
<IndexTerm>
<Primary>XmSetFontUnits</Primary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/Xm.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmSetFontUnits</Function></FuncDef>
<!--<ParamDef><Replaceable>display, h_value, v_value</Replaceable></ParamDef>-->
<ParamDef>Display <Parameter>* display</Parameter></ParamDef>
<ParamDef>int <Parameter>h_value</Parameter></ParamDef>
<ParamDef>int <Parameter>v_value</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmSetFontUnits</Function> provides an external function to initialize font unit
values. Applications may want to specify resolution-independent data based
on a global font size. This function must be called before any widgets with
resolution-independent data are created. See the <SystemItem Class="Resource">XmNunitType</SystemItem>
resource description in the reference pages for
<Classname>XmGadget</Classname>, <Classname>XmManager</Classname>, and <Classname>XmPrimitive</Classname> for more information
on resolution independence.
</Para>
<Para>This function sets the font units for all screens on the display.
</Para>
<Para><Literal>NOTE:</Literal>
<Function>XmSetFontUnits</Function> is obsolete and exists for compatibility with
previous releases.
Instead of using this function, provide initial values or call
<Function>XtSetValues</Function> for the XmScreen resources <SystemItem Class="Resource">XmNhorizontalFontUnit</SystemItem>
and <SystemItem Class="Resource">XmNverticalFontUnit</SystemItem>.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">display</Symbol></Term>
<ListItem>
<Para>Defines the display for which this font unit value is to be applied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">h_value</Symbol></Term>
<ListItem>
<Para>Specifies the value to be used for horizontal
units in the conversion calculations.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">h_value</Symbol></Term>
<ListItem>
<Para>Specifies the value to be used for vertical
units in the conversion calculations.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmConvertUnits;,
&cdeman.XmSetFontUnit;,
&cdeman.XmGadget;,
&cdeman.XmManager;,
&cdeman.XmPrimitive;, and
&cdeman.XmScreen;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
