forked from KolibriOS/kolibrios
Evgeny Grechnikov (Diamond)
fca4378433
git-svn-id: svn://kolibrios.org@836 a494cfbc-eb01-0410-851d-a64ba20cac60
115 lines
4.3 KiB
Plaintext
115 lines
4.3 KiB
Plaintext
console.obj экспортирует следующие функции:
|
|
|
|
typedef unsigned long dword; /* 32-битное беззнаковое целое */
|
|
typedef unsigned short word; /* 16-битное беззнаковое целое */
|
|
|
|
void __stdcall con_init(dword wnd_width, dword wnd_height,
|
|
dword scr_width, dword scr_height, const char* title);
|
|
Инициализация консоли. Вызывается один раз в начале программы.
|
|
wnd_width, wnd_height - высота и ширина (в символах) видимой в окне консоли
|
|
области;
|
|
scr_width, scr_height - высота и ширина (в символах) всей консоли;
|
|
любые из первых 4 параметров могут быть установлены в -1 (=0xFFFFFFFF)
|
|
- использовать значения по умолчанию;
|
|
title - заголовок окна консоли.
|
|
|
|
void __stdcall con_exit(bool bCloseWindow);
|
|
Вызывается при завершении программы. Если (байтовый) параметр bCloseWindow
|
|
нулевой, то окно консоли остаётся на экране до того момента, как пользователь
|
|
пожелает закрыть его, при этом к заголовку добавляется строка " [Finished]".
|
|
|
|
void __stdcall con_set_title(const char* title);
|
|
Устанавливает новый заголовок окна консоли.
|
|
|
|
void __stdcall con_write_asciiz(const char* string);
|
|
Выводит ASCIIZ-строку в консоль в текущую позицию, продвигает текущую позицию.
|
|
|
|
void __stdcall con_write_string(const char* string, dword length);
|
|
Аналогично con_write_asciiz, но выводит ровно length символов.
|
|
|
|
int __cdecl con_printf(const char* format, ...)
|
|
Стандартная printf из ANSI C.
|
|
|
|
dword __stdcall con_get_flags(void);
|
|
Получает значение флагов вывода.
|
|
dword __stdcall con_set_flags(dword new_flags);
|
|
Устанавливает значение флагов вывода. Возвращает старое значение.
|
|
Флаги (битовая маска):
|
|
/* цвет текста */
|
|
#define CON_COLOR_BLUE 1
|
|
#define CON_COLOR_GREEN 2
|
|
#define CON_COLOR_RED 4
|
|
#define CON_COLOR_BRIGHT 8
|
|
/* цвет фона */
|
|
#define CON_BGR_BLUE 0x10
|
|
#define CON_BGR_GREEN 0x20
|
|
#define CON_BGR_RED 0x40
|
|
#define CON_BGR_BRIGHT 0x80
|
|
/* управление выводом */
|
|
#define CON_IGNORE_SPECIALS 0x100
|
|
/* Если флаг сброшен, функция интерпретирует специальные символы:
|
|
10 ('\n') - перевод в начало следующей строки
|
|
13 ('\r') - перевод в начало текущей строки
|
|
8 ('\b') - забой (на символ назад)
|
|
9 ('\t') - табуляция
|
|
27 ('\033'='\x1B') - начало Esc-последовательности;
|
|
иначе выводит их как обычные символы. */
|
|
/* Поддерживаемые Esc-последовательности:
|
|
Esc[<number1>;<number2>;<number3>m - выбор атрибутов символов:
|
|
можно указывать один, два или три кода в любом порядке;
|
|
0 = нормальное изображение (белые символы на чёрном фоне)
|
|
1 = выделение яркостью
|
|
5 = яркий фон
|
|
7 = реверсное изображение (чёрные символы на белом фоне)
|
|
30 = чёрные символы
|
|
31 = красные символы
|
|
32 = зелёные символы
|
|
33 = коричневые символы
|
|
34 = синие символы
|
|
35 = фиолетовые символы
|
|
36 = бирюзовые символы
|
|
37 = белые символы
|
|
40 = чёрный фон
|
|
41 = красный фон
|
|
42 = зелёный фон
|
|
43 = коричневый фон
|
|
44 = синий фон
|
|
45 = фиолетовый фон
|
|
46 = бирюзовый фон
|
|
47 = белый фон
|
|
*/
|
|
Значение по умолчанию для флагов = 7.
|
|
|
|
int __stdcall con_get_font_height(void);
|
|
Возвращает значение высоты шрифта.
|
|
|
|
int __stdcall con_get_cursor_height(void);
|
|
Получает значение высоты курсора.
|
|
int __stdcall con_set_cursor_height(int new_height);
|
|
Устанавливает значение высоты курсора. Возвращает старое значение.
|
|
Попытка установить значение вне корректного интервала (от 0 до font_height-1)
|
|
игнорируется.
|
|
Курсор высоты 0 не отображается на экране.
|
|
Значение высоты по умолчанию - 15% от высоты шрифта.
|
|
|
|
int __stdcall con_getch(void);
|
|
Считывает один символ с клавиатуры.
|
|
Для обычных символов возвращается ASCII-код. Для расширенных символов
|
|
(например, Fx и стрелочек) первый вызов функции возвращает 0,
|
|
а повторный вызов возвращает расширенный код (подобно DOS-функциям ввода).
|
|
|
|
word __stdcall con_getch2(void);
|
|
Считывает один символ с клавиатуры. Младший байт содержит ASCII-код клавиши
|
|
(0 для расширенных символов), старший - расширенный код
|
|
(подобно BIOS-функциям ввода).
|
|
|
|
int __stdcall con_kbhit(void);
|
|
Возвращает 1, если какая-то клавиша была нажата, 0 иначе. Для считывания
|
|
нажатой клавиши предназначены функции con_getch и con_getch2.
|
|
|
|
void __stdcall con_gets(char* str, int n);
|
|
Считывает строку с клавиатуры. Ввод прерывается при поступлении символа
|
|
новой строки, а также по прочтении n-1 символа (в зависимости от того, что
|
|
произойдёт раньше). В первом случае символ новой строки также записывается в
|
|
str. Считанная строка дополняется нулевым символом.
|