Section 3: library functions
set_line_spacing Synopsis#include <gstream.h> void set_line_spacing(int ls); DescriptionSets the line spacing in pixels. The supplied value is added to the height of the font so if your font is 12 pixels high, and you call this function with 4, then the outputter will go 16 pixels down each time a newline is encountered, effectively making the…
set_input_string Synopsis#include <gstream.h> void set_input_string(char const *s); DescriptionThis function provides a way to specify an editable default string when inputting. Consider the following example: char buf[100]; gs << "What’s your opinion about gstream?\n"; gs.set_input_string("I think it is incredible wonderful!"); gs.getline(buf, 100);The user will see the following What’s your opinion about gstream? I think it is…
set_input_error_handler Synopsis#include <gstream.h> void set_input_error_handler(int error); DescriptionSets an error handler that will be called of the inputter encounter any unusual, erratic behaviour, e.g. the user trying to move the cursor off the string or pressing invalid keys. The handler is passed a constant which currently can be one of the following: IE_UNRECOGNIZED_KEY The inputted key…
set_input_approver Synopsis#include <gstream.h> void set_input_approver(bool (*input_approver)(int)); DescriptionThe function handed over will be called with every new character inputted and determines whether the character will be accepted by the inputter. If it returns true, the character is accepted and inserted in the input string, if false, the character is thrown away. A short example: bool ia_abc_is_what_we_want(int…
set_dirty_rectangle_marker Synopsis#include <gstream.h> void set_dirty_rectangle_marker(void (*drm)(int, int, int, int)) DescriptionSets a function which the gstream will use to mark the areas that it draws inside as "dirty"; this can, for instance, be very useful in conjuction with a dirty rectangle system in a game where you are using the gstream to output various information during…
set_cursor_drawer Synopsis#include <gstream.h> void set_cursor_drawer(void (*cd)(BITMAP *, int, int, int, int, int, bool)); DescriptionThis will set the function for drawing the cursor, which is useful if you want to customize it with your own favourite cursor (perhaps a BITMAP). Before you can actually use the cursor for inputting, you also have to call set_cursor_dimensions with…
set_cursor_dimensions Synopsis#include <gstream.h> void set_cursor_dimensions(int iw, int ih, int ow, int oh); DescriptionThis will set the cursor dimensions to IW x IH when in insert mode and OW x OH when in overwrite mode. Although the standard cursors respond to this, it is mostly intended to be used with custom cursor drawers. Before requesting any…
save_input_approver Synopsis#include <gstream.h> void save_input_approver(); DescriptionA typical use of the input approver system is to temporarily set a home-made approver, launch an input and then get the original settings back. Consequently there is a pair of functions to help you with that, save_input_approver and restore_input_approver. Saving will backup the currently used approver, so you can…
restore_input_approver Synopsis#include <gstream.h> void restore_input_approver(); DescriptionRestores the previously saved backup. You can call this function as many times as you want, i.e. the backup will remain the same until you save another approver. See Alsogstream-save_input_approver(3), gstream-set_input_approver(3), gstream-get_input_approver(3)
restore Synopsis#include <gstream.h> void restore(); DescriptionWhen you have activated a tabulator stop (by using the ‘\t’ character), it might change the colour or the font depending on what or what not you have told it to do. To get the original settings back you can call this function. It is automatically called when a newline…
operator, operator Synopsis#include <gstream.h> ostream& operator<<(ostream& o, fix const& x); istream& operator>>(istream& i, fix& x); DescriptionThese two functions don’t actually belong to the gstreams, they are here simply because they sometimes make the life a bit easier (without costing anything in executable size if they are left unused). Their purpose is to make the class…
goto_row Synopsis#include <gstream.h> void goto_row(int row); DescriptionMoves the cursor to line number ROW. If, for instance, the currently used font has a height of 12, then goto_row(4) is exactly the same as goto_y(4*12). Unless, of course, you use another line spacing than the default as the formula is y-coordinate = line_spacing * rowSee Alsogstream-move_row(3), gstream-goto_xy(3)
cd_winconsole Synopsis#include <gstream.h> void cd_winconsole(BITMAP *bmp, int x, int y, int w, int h, int clr, bool ins); DescriptionDraws a mixture of a win cursor and console cursor: the insert cursor looks like a win cursor (a vertical line: | ), whereas the overwrite cursor is like the console overwrite cursor (it covers the letter)….
cd_console Synopsis#include <gstream.h> void cd_console(BITMAP *bmp, int x, int y, int w, int h, int clr, bool ins); DescriptionDraws a normal console cursor: the insert cursor is like an _, and the overwrite cursor covers the letter. The preferred dimensions (you have to set them manually) are: (gbuf::DYNAMIC_CURSOR_SIZE, gbuf::DYNAMIC_CURSOR_SIZE, gbuf::DYNAMIC_CURSOR_SIZE, gbuf::DYNAMIC_CURSOR_SIZE) but the second argument…
GSTREAM_DATE_STR Synopsis#include <gstream.h> char GSTREAM_DATE_STR[] DescriptionThis will contain the year of the current version of the library. For example, for version 1.0 of the library, this string will be "1999". (For version 19.43 it will probably be "3061" :-) See Alsogstream-GSTREAM_VERSION_STR(3), gstream-GSTREAM_VERSION(3), gstream-GSTREAM_SUB_VERSION(3)
gss_accept_sec_context gss_acquire_cred gss_add_cred gss_add_oid_set_member gss_canonicalize_name gss_compare_name gss_context_time gss_create_empty_oid_set gss_delete_sec_context gss_display_name gss_display_status gss_duplicate_name gss_export_name gss_export_sec_context gss_get_mic gss_import_name gss_import_sec_context gss_indicate_mechs gss_init_sec_context gss_inquire_context gss_inquire_cred gss_inquire_cred_by_mech gss_inquire_mechs_for_name gss_inquire_names_for_mech gss_krb5_ccache_name gss_krb5_compat_des3_mic gss_krb5_copy_ccache gss_krb5_import_cred gsskrb5_extract_authz_data_from_sec_context gsskrb5_register_acceptor_identity gss_krb5_import_ccache gss_krb5_get_tkt_flags gss_process_context_token gss_release_buffer gss_release_cred gss_release_name gss_release_oid_set gss_seal gss_sign gss_test_oid_set_member gss_unseal gss_unwrap gss_verify gss_verify_mic gss_wrap gss_wrap_size_limit – Generic Security Service Application Program Interface library LibraryGSS-API…
gss_accept_sec_context gss_acquire_cred gss_add_cred gss_add_oid_set_member gss_canonicalize_name gss_compare_name gss_context_time gss_create_empty_oid_set gss_delete_sec_context gss_display_name gss_display_status gss_duplicate_name gss_export_name gss_export_sec_context gss_get_mic gss_import_name gss_import_sec_context gss_indicate_mechs gss_init_sec_context gss_inquire_context gss_inquire_cred gss_inquire_cred_by_mech gss_inquire_mechs_for_name gss_inquire_names_for_mech gss_krb5_ccache_name gss_krb5_compat_des3_mic gss_krb5_copy_ccache gss_krb5_import_cred gsskrb5_extract_authz_data_from_sec_context gsskrb5_register_acceptor_identity gss_krb5_import_ccache gss_krb5_get_tkt_flags gss_process_context_token gss_release_buffer gss_release_cred gss_release_name gss_release_oid_set gss_seal gss_sign gss_test_oid_set_member gss_unseal gss_unwrap gss_verify gss_verify_mic gss_wrap gss_wrap_size_limit – Generic Security Service Application Program Interface library LibraryGSS-API…
gssapi_services_intro – Introduction to GSS-API services GSS-API servicesContext creation• delegation • mutual authentication • anonymous • use per message before context creation has completed return status: • support conf • support intContext creation flags• GSS_C_DELEG_FLAG • GSS_C_MUTUAL_FLAG • GSS_C_REPLAY_FLAG • GSS_C_SEQUENCE_FLAG • GSS_C_CONF_FLAG • GSS_C_INTEG_FLAG • GSS_C_ANON_FLAG • GSS_C_PROT_READY_FLAG • GSS_C_TRANS_FLAG • GSS_C_DCE_STYLE • GSS_C_IDENTIFY_FLAG…
gssapi_mechs_intro – GSS-API mechanisms GSS-API mechanisms• Kerberos 5 – GSS_KRB5_MECHANISM • SPNEGO – GSS_SPNEGO_MECHANISM • NTLM – GSS_NTLM_MECHANISM
Heimdal GSS-API functions – FunctionsGSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_add_oid_set_member (OM_uint32 *minor_status, const gss_OID member_oid, gss_OID_set *oid_set)" GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov (OM_uint32 *minor_status, gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, int *conf_state, gss_iov_buffer_desc *iov, int iov_count)" GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_unwrap_iov (OM_uint32 *minor_status, gss_ctx_id_t context_handle, int *conf_state, gss_qop_t *qop_state, gss_iov_buffer_desc *iov, int iov_count)" GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov_length (OM_uint32 *minor_status,…