usr/src/lib/libcurses/screen/delay_out.c

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22 /*
  23  * Copyright 1997 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26
  27 /*      Copyright (c) 1988 AT&T */
  28 /*        All Rights Reserved   */
  29
  30 /*
  31  * University Copyright- Copyright (c) 1982, 1986, 1988
  32  * The Regents of the University of California
  33  * All Rights Reserved
  34  *
  35  * University Acknowledgment- Portions of this document are derived from
  36  * software developed by the University of California, Berkeley, and its
  37  * contributors.
  38  */
  39
  40 #pragma ident   "%Z%%M% %I%     %E% SMI"
  41
  42 /*LINTLIBRARY*/
  43
  44 /*
  45  * Code for various kinds of delays.  Most of this is nonportable and
  46  * requires various enhancements to the operating system, so it won't
  47  * work on all systems.  It is included in curses to provide a portable
  48  * interface, and so curses itself can use it for function keys.
  49  */
  50
  51 #include        <sys/types.h>
  52 #include        "curses_inc.h"
  53
  54 /*
  55  * Delay the output for ms milliseconds.
  56  * Note that this is NOT the same as a high resolution sleep.  It will
  57  * cause a delay in the output but will not necessarily suspend the
  58  * processor.  For applications needing to sleep for 1/10th second,
  59  * this is not a usable substitute.  It causes a pause in the displayed
  60  * output, for example, for the eye wink in snake.  It is disrecommended
  61  * for "delay" to be much more than 1/2 second, especially at high
  62  * baud rates, because of all the characters it will output.  Note
  63  * that due to system delays, the actual pause could be even more.
  64  * You can't get a decent pac-man game with this routine.
  65  */
  66
  67 int
  68 delay_output(int ms)
  69 {
  70         extern  int     _outchar(char);
  71
  72         return (_delay(ms * 10, _outchar));
  73 }