osdOutputPrintLine

osd

1998 12-05

NAME

osdOutputPrintLine - print a line of output

SYNOPSIS

long osdOutputPrintLine(OSD_Output *output, char *title,char *string)

osdOutputPrintLine() prints a line of output with a title. See osdOutputSetFlags() for a description of the types of output. The title of a message is used as the window label for OSD_OUT_MESSAGEBOX output. For other types of output title is printed out as a colon separated prefix to message.

Return TRUE on success and FALSE on failure.

ARGUMENTS

output	the OSD_Output to configure
title	pointer to the title of the message line
string	pointer to the message

EXAMPLES

In a program:
osdOutputPrintLine(output_ptr, "TITLE", "message text");

Line Output:
TITLE: message text

NOTES

The call osdOutputRaw(), called indirectly by osdOutputPrintLine(), will translate a few standard ANSI sequences into non-standard Win32 equivalents. (Although the Win32 allows an "ANSI" mode, they recognize absolutely no ANSI codes.) The codes translated by osdOutputRaw() include only the color indexes 0, 1, 2, 30, 31, 32, 33, 34, 35, 36, 37 replacing "?" in the code sequence "^[[?m". The indexes 0, 1, and 2 are translated into white, dark cyan, and dark red, respectively. The indexes 30 to 37 translate into black, red, green, yellow, blue, magenta, cyan, and white. Any unknown index translates into white. Any other ANSI sequences are likely to result in undesirable results.