<refentry id="glutBitmapCharacter.3GLUT">
	<refmeta id="glutBitmapCharacter.3GLUT-meta">
		<refentrytitle>glutBitmapCharacter</refentrytitle>
		<manvolnum>3GLUT</manvolnum>
	</refmeta>
	<refnamediv id="glutBitmapCharacter.3GLUT-name">
		<refname>glutBitmapCharacter</refname>
		<refpurpose>renders a bitmap character using OpenGL.</refpurpose>
	</refnamediv>
	<refsynopsisdiv id="glutBitmapCharacter.3GLUT-c_spec">
		<title>C Specification</title>
		<funcsynopsis>
			<funcprototype>
				<funcdef>void&nbsp;<function>glutBitmapCharacter</function></funcdef>
				<paramdef>void&nbsp;*<parameter>font</parameter></paramdef>
				<paramdef>int&nbsp;<parameter>character</parameter></paramdef>
			</funcprototype>
		</funcsynopsis>
	</refsynopsisdiv>
	<refsect1 id="glutBitmapCharacter.3GLUT-parameters">
		<title>Parameters</title>
		<variablelist>
			<varlistentry>
				<term><parameter>font</parameter></term>
				<listitem>
					<simpara>
						Bitmap font to use.
					</simpara>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><parameter>character</parameter></term>
				<listitem>
					<simpara>
						Character to render (not confined to 8 bits).
					</simpara>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>
	<refsect1 id="glutBitmapCharacter.3GLUT-description">
		<title>Description</title>
		<para>
			Without using any display lists, <function>glutBitmapCharacter</function> renders the character in the named bitmap
			font. The available fonts are:
		</para>
		<variablelist>
			<varlistentry>
				<term><constant>GLUT_BITMAP_8_BY_13</constant></term>
				<listitem>
					<simpara>
						A fixed width font with every character fitting in an 8 by 13 pixel rectangle. The exact bitmaps to be used
						is defined by the standard X glyph bitmaps for the X font named:
					</simpara>
					<screen>-misc-fixed-medium-r-normal--13-120-75-75-C-80-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_9_BY_15</constant></term>
				<listitem>
					<simpara>
						A fixed width font with every character fitting in an 9 by 15 pixel rectangle. The exact bitmaps to be used
						is defined by the standard X glyph bitmaps for the X font named:
					</simpara>
					<screen>-misc-fixed-medium-r-normal--15-140-75-75-C-90-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_TIMES_ROMAN_10</constant></term>
				<listitem>
					<simpara>
						A 10-point proportional spaced Times Roman font. The exact bitmaps to be used is defined by the standard X
						glyph bitmaps for the X font named:
					</simpara>
					<screen>-adobe-times-medium-r-normal--10-100-75-75-p-54-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_TIMES_ROMAN_24</constant></term>
				<listitem>
					<simpara>
						A 24-point proportional spaced Times Roman font. The exact bitmaps to be used is defined by the standard X
						glyph bitmaps for the X font named:
					</simpara>
					<screen>-adobe-times-medium-r-normal--24-240-75-75-p-124-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_HELVETICA_10</constant></term>
				<listitem>
					<simpara>
						A 10-point proportional spaced Helvetica font. The exact bitmaps to be used is defined by the standard X
						glyph bitmaps for the X font named:
					</simpara>
					<screen>-adobe-helvetica-medium-r-normal--10-100-75-75-p-56-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_HELVETICA_12</constant></term>
				<listitem>
					<simpara>
						A 12-point proportional spaced Helvetica font. The exact bitmaps to be used is defined by the standard X
						glyph bitmaps for the X font named:
					</simpara>
					<screen>-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1</screen>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><constant>GLUT_BITMAP_HELVETICA_18</constant></term>
				<listitem>
					<simpara>
						A 18-point proportional spaced Helvetica font. The exact bitmaps to be used is defined by the standard X
						glyph bitmaps for the X font named:
					</simpara>
					<screen>-adobe-helvetica-medium-r-normal--18-180-75-75-p-98-iso8859-1</screen>
				</listitem>
			</varlistentry>
		</variablelist>
		<para>
			Rendering a nonexistent character has no effect. glutBitmapCharacter automatically sets the OpenGL unpack pixel storage
			modes it needs appropriately and saves and restores the previous modes before returning. The generated call to glBitmap
			will adjust the current raster position based on the width of the character.
		</para>
	</refsect1>
	<refsect1 id="glutBitmapCharacter.3GLUT-example">
		<title>Example</title>
		<para>
			Here is a routine that shows how to render a string of ASCII text with <function>glutBitmapCharacter</function>:
		</para>
		<programlisting>void output(int x, int y, char *string)
{
  int len, i;
  glRasterPos2f(x, y);
  len = (int) strlen(string);
  for (i = 0; i &lt; len; i++)
  {
    glutBitmapCharacter(GLUT_BITMAP_HELVETICA_18, string[i]);
  }
}</programlisting>
	</refsect1>
	<refsect1 id="glutBitmapCharacter.3GLUT-see_also">
		<title>See Also</title>
		<para>
			<simplelist type="inline">
				<member><citerefentry>
					<refentrytitle>glutBitmapWidth</refentrytitle>
					<manvolnum>3GLUT</manvolnum>
				</citerefentry></member>
				<member><citerefentry>
					<refentrytitle>glutStrokeCharacter</refentrytitle>
					<manvolnum>3GLUT</manvolnum>
				</citerefentry></member>
			</simplelist>
		</para>
	</refsect1>
</refentry>
