<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="flprintk">
  <refmeta>
    <refentrytitle>FLprintk</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>FLprintk</refname>
    <refpurpose>
      A FLTK opcode that prints a k-rate value at specified intervals.
      <indexterm id="IndexFlprintk"><primary>FLprintk</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      <emphasis>FLprintk</emphasis> is similar to <link linkend="printk"><citetitle>printk</citetitle></link> but shows values of a k-rate signal in a text field instead of on the console.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>FLprintk</command> itime, kval, idisp</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>itime</emphasis> -- how much time in seconds is to elapse between updated displays.
    </para>

    <para>
      <emphasis>idisp</emphasis> -- a handle value that was output from a previous instance of the <link linkend="flvalue"><citetitle>FLvalue</citetitle></link> opcode to display the current value of the current valuator in the <emphasis>FLvalue</emphasis> widget itself. If the user doesn't want to use this feature that displays current values, it must be set to a negative number by the user.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>kval</emphasis> -- k-rate signal to be displayed.
    </para>

    <para>
      <emphasis>FLprintk</emphasis> is similar to <link linkend="printk"><citetitle>printk</citetitle></link>, but shows values of a k-rate signal in a text field instead of showing it in the console. The <emphasis>idisp</emphasis> argument must be filled with the <emphasis>ihandle</emphasis> return value of a previous <emphasis>FLvalue</emphasis> opcode. While <emphasis>FLvalue</emphasis> should be placed in the header section of an orchestra inside an <link linkend="flpanel"><citetitle>FLpanel</citetitle></link>/<link linkend="flpanelend"><citetitle>FLpanelEnd</citetitle></link> block, <emphasis>FLprintk</emphasis> must be placed inside an instrument to operate correctly. For this reason, it slows down performance and should be used for debugging purposes only.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="flbox"><citetitle>FLbox</citetitle></link>,
      <link linkend="flbutbank"><citetitle>FLbutBank</citetitle></link>,
      <link linkend="flbutton"><citetitle>FLbutton</citetitle></link>,
      <link linkend="flprintk2"><citetitle>FLprintk2</citetitle></link>,
      <link linkend="flvalue"><citetitle>FLvalue</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Author: &namegabriel;</para>
    <para>New in version 4.22</para>
  </refsect1>
</refentry>
