Scroll to navigation

brlapi_info(3) Library Functions Manual brlapi_info(3)

NAME

brlapi_info - Getting Terminal information


- How to get information about the connected Terminal.

SYNOPSIS

Macros


#define BRLAPI_MAXNAMELENGTH 31

Functions


int BRLAPI_STDCALL brlapi_getDriverName (char *buffer, size_t size)
int BRLAPI_STDCALL brlapi__getDriverName (brlapi_handle_t *handle, char *buffer, size_t size)
int BRLAPI_STDCALL brlapi_getModelIdentifier (char *buffer, size_t size)
int BRLAPI_STDCALL brlapi__getModelIdentifier (brlapi_handle_t *handle, char *buffer, size_t size)
int BRLAPI_STDCALL brlapi_getDisplaySize (unsigned int *x, unsigned int *y)
int BRLAPI_STDCALL brlapi__getDisplaySize (brlapi_handle_t *handle, unsigned int *x, unsigned int *y)

Detailed Description

Before using Raw mode or key codes, the application should always check the type of the connected terminal, to be sure it is really the one it expects.

One should also check for display size, so as to adjust further displaying on it.

Macro Definition Documentation

#define BRLAPI_MAXNAMELENGTH 31

Maximum name length for driver names embedded in BrlAPI packets, not counting any termination \0 character

Function Documentation

int BRLAPI_STDCALL brlapi__getDisplaySize (brlapi_handle_t * handle, unsigned int * x, unsigned int * y)

References brlapi__getDisplaySize(), and BRLAPI_STDCALL.

Referenced by brlapi__getDisplaySize().

int BRLAPI_STDCALL brlapi__getDriverName (brlapi_handle_t * handle, char * buffer, size_t size)

References brlapi__getDriverName(), and BRLAPI_STDCALL.

Referenced by brlapi__getDriverName().

int BRLAPI_STDCALL brlapi__getModelIdentifier (brlapi_handle_t * handle, char * buffer, size_t size)

References brlapi__getModelIdentifier(), and BRLAPI_STDCALL.

Referenced by brlapi__getModelIdentifier().

int BRLAPI_STDCALL brlapi_getDisplaySize (unsigned int * x, unsigned int * y)

Return the size of the braille display

References brlapi_getDisplaySize(), and BRLAPI_STDCALL.

Referenced by brlapi_getDisplaySize().

int BRLAPI_STDCALL brlapi_getDriverName (char * buffer, size_t size)

Return the complete name of the driver used by brltty

This function fills its argument with the whole name of the braille driver if available, terminated with a '\0'.

Parameters

buffer is the buffer provided by the application;
size is the maximum size for the name buffer.

Returns

-1 on error, otherwise a positive value giving the size of the needed buffer (including '\0'). If that value is bigger than size, the value was truncated and the caller should retry with a bigger buffer accordingly.

References brlapi_getDriverName(), and BRLAPI_STDCALL.

Referenced by brlapi_getDriverName().

int BRLAPI_STDCALL brlapi_getModelIdentifier (char * buffer, size_t size)

Return an identifier for the device model used by brltty

This function fills its argument with the whole identifier of the braille device model if available, terminated with a '\0'.

Parameters

buffer is the buffer given by the application;
size is the maximum size for the identifier buffer.

Returns

-1 on error, otherwise a positive value giving the size of the needed buffer (including '\0'). If that value is bigger than size, the value was truncated and the caller should retry with a bigger buffer accordingly.

References brlapi_getModelIdentifier(), and BRLAPI_STDCALL.

Referenced by brlapi_getModelIdentifier().

Author

Generated automatically by Doxygen for BrlAPI from the source code.

Version 0.8 BrlAPI