Tappin's Graffer
The following is a listing of the entire contents of this library for IDL.
Click on an individual procedure name to view its header and
source code. This listing
is a shortened form of the much longer
entire library help file . This may be handy for
text searchs, be beware that some of these are huge and may take a long
time to load or even crash your browser.
Last modified: Thu Dec 21 21:28:26 2000.
List of Routines
ASPECT This function calculates and returns the normalized position coordinates necessary to put a plot with a specified aspect ratio into the currently active graphics window. It works on the display output window as well as in a PostScript output window.
CW_BBSELECTOR CW_BBSELECTOR is a compound widget that appears as a pull-down menu whose label shows the widget's current value. When the button is pressed, the menu appears and the newly selected value becomes the new title of the pull-down menu.
CW_BTGROUP CW_BTGROUP is a compound widget that simplifies creating a base of buttons. It handles the details of creating the proper base (standard, exclusive, or non-exclusive) and filling in the desired buttons. Events for the individual buttons are handled transparently, and a CW_BTGROUP event returned. This event can return any one of the following: - The Index of the button within the base. - The widget ID of the button. - The name of the button. - An arbitrary value taken from an array of User values.
CW_PDTMENU CW_PDTMENU is a compound widget that simplifies creating pulldown menus. It has a simpler interface than the XPDTMENU procedure, which it is intended to replace. Events for the individual buttons are handled transparently, and a CW_PDTMENU event returned. This event can return any one of the following: - The Index of the button within the base. - The widget ID of the button. - The name of the button. - The fully qualified name of the button. This allows different sub-menus to contain buttons with the same
CW_PDTSMENU CW_PDTSMENU is a compound widget that simplifies creating pulldown menus. It has a simpler interface than the XPDTSMENU procedure, which it is intended to replace. Events for the individual buttons are handled transparently, and a CW_PDTSMENU event returned. This event can return any one of the following: - The Index of the button within the base. - The widget ID of the button. - The name of the button. - The fully qualified name of the button. This allows different sub-menus to contain buttons with the same
ERRPLOT[1] Plot radial error bars over a previously drawn plot.
ERRPLOT[2] Plot horizontal error bars over a previously drawn plot.
ERRPLOT[2] Plot radial error bars over a previously drawn plot.
ERRPLOT[3] Plot error bars over a previously drawn plot.
FRACTILE Return the requested fractile of the input data. fr = fractile(x, frac) fr The requested fractile. Arguments: x most input The array whose fractile(s) are to be returned
GRAFFER Simple interactive data plotter. graffer[, group=group] Argument: file string input The initial filename for the graph Keywords: group long input The group leader of the widget tree.
GRAFF_ADD GRAFF_ADD User-callable interface to add a dataset to a graffer file. graff_add, file, [[[z], x,] y, errors=errors, funcx=funcx, $ funcy=funcy, errtype=errtype, funcz=funcz, $ polar=polar, rescale=rescale, /display, join=join, $ style=style, psym=psym, symsize=symsize, colour=colour, $
GRAFF_CH_DSET GRAFF_CH_DSET Change data set graff_ch_dset, pdefs Argument: pdefs struct in/out The plot definition structure. Original (essentially a widget version of graff_dset): 7/9/95; SJT
GRAFF_CLEAR GRAFF_CLEAR Release memory from handles in a Graffer plot structure graff_clear,pdefs Argument: pdefs struct in/out The graffer control structure The structure is not usable after clearing until
GRAFF_COLOURS GRAFF_COLOURS Sets up the colour table for graffer. graff_colours, pdefs ; Not indended for use by the user. Argument: pdefs struct input GRAFFER control structure (only colour table is used
GRAFF_DECODE_XY GRAFF_DECODE_XY Decode an array of X-Y[-err-err] values data = graff_decode_xy(txt,nt) Return Value: data float (nt x m) array of values & errors (nt = 2, 3 or Arguments:
GRAFF_DRAW GRAFF_DRAW Process a draw event in draw mode ichange = graff_draw(pdefs, event, track_flag) Argument: pdefs struct in/out The plot definition structure. event struct input The draw event that triggered this
GRAFF_DSDEL GRAFF_DSDEL Delete the current data set. graff_dsdel, pdefs pdefs struct input The graffer structure, needed if save requested. Original: 29/8/95; SJT
GRAFF_DUMP GRAFF_DUMP Dump the contents of the draw widget to an image file. graff_dump, pdefs[, ] Argument: Pdefs struct input The graffer data structure (only used for file and dir)
GRAFF_ENTER GRAFF_ENTER A labeled text entry field id = graff_enter(parent, ...) id long The ID of the compound widget Argument: parent long input The ID of the base in which the widget
GRAFF_FNAME GRAFF_FNAME Get a graffer filename file = graff_fname(topid, ifile, dir) file string The filename (graffer.grf if null) Arguments: topid long input Widget ID of group leader
GRAFF_FUNCT GRAFF_FUNCT Define a function to graffer. ichange=graff_funct(pdefs) Return value: ichange int 1 if the DO button was used, 0 if cancel Argument:
GRAFF_GET GRAFF_GET Get a graffer dataset from a file iopen = graff_get(pdefs[, f]) Return Value: iopen int 1 If file was opened; 0 if not. Argument:
GRAFF_HARD GRAFF_HARD Make a hardcopy ichange = graff_hard(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
GRAFF_INIT GRAFF_INIT Set up a new graffer plot structure graff_init, pdefs Argument: pdefs struct output The graffer plot structure. file string input The filename for the new plot.
GRAFF_JUST GRAFF_JUST Set "non-standard" text justification align = graff_just(initial, group=group) Return Value: align float The new justification setting Argument:
GRAFF_MSG GRAFF_MSG Display a message in the graffer message box graff_msg, mwid, message Arguments: mwid long input Widget ID of message box message string input The message
GRAFF_ONE GRAFF_ONE Define a full-sized screen for graffer. (May not be called directly by the user) graff_one, pdefs, group=group, xsize=xsize, ysize=ysize Argument: pdefs struct in/out A GRAFFER control structure as
GRAFF_PFUNCT GRAFF_PFUNCT Define a parametric function to graffer. ichange=graff_pfunct(pdefs) Return value: ichange int 1 if the DO button was used, 0 if cancel Argument:
GRAFF_PROPS GRAFF_PROPS User-callable interface to set global properties of a graffer graff_props, file, title=title, subtitle=subtitle, $ charsize=charsize, thick=thick, corners=corners, $ aspect=aspect, comment=comment, xtitle=xtitle, $ xrange=xrange, xlog=xlog, xexact=xexact, $
GRAFF_RESCALE GRAFF_RESCALE Rescale the current GRAFFER dataset ichange = graff_rescale(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
GRAFF_SET_VALS GRAFF_SET_VALS Setup the values of the graffer widgets graff_set_vals, pdefs Argument: pdefs struct input The graffer control structure set_only input If set, then only do those values
GRAFF_SORT_DSS GRAFF_SORT_DSS Change data set graff_sort_dss, pdefs Argument: pdefs struct in/out The plot definition structure. Original (after graff_ch_dset): 6/12/96; SJT
GRAFF_S_PROMPT GRAFF_S_PROMPT Do you really want to destroy what you just did? ido = graff_s_prompt(pdefs) ido int Do I go on? pdefs struct input The graffer structure, needed if save requested.
GRAFF_TEXT GRAFF_TEXT Add text to a graffer plot. ichange = graff_text(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
GRAFF_TLV GRAFF_TLV Construct a graffer data set from top-level variables ichange = graff_tlv(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
GRAFF_TWO GRAFF_TWO Define a more compact screen for graffer. (May not be called directly by the user) graff_two, pdefs, group=group, xsize=xsize, ysize=ysize Argument: pdefs struct in/out A GRAFFER control structure as
GRAFF_WRITE GRAFF_WRITE Process a draw event in text mode ichange = graff_write(pdefs, event, track_flag) Return value ichange int 1 if changed, 0 if not Argument:
GRAFF_ZFUNCT GRAFF_ZFUNCT Define a 2-D function to graffer. ichange = graff_zfunct(pdefs) Return value: ichange int 1 if the DO button was used, 0 if cancel Argument:
GRF_TLV_GET GRF_TLV_GET Get a variable from the top level. var = grf_tlv_get(vn, n_var) Return value: var any The value or array of values returned from the top level.
GR_1DD_PLOT GR_1DD_PLOT Plot a 1-D Data in graffer gr_1dd_plot, pdefs, i Argument: pdefs struct input The Graffer control structure. i int input Which
GR_1DF_PLOT GR_1DF_PLOT Plot a 1-D function in graffer gr_1df_plot, pdefs, i Argument: pdefs struct input The Graffer control structure. i int input Which
GR_2DD_PLOT GR_2DD_PLOT Plot a 2-D Data in graffer gr_2dd_plot, pdefs, i Argument: pdefs struct input The Graffer control structure. i int input Which
GR_2DF_PLOT GR_2DF_PLOT Display a 2-d function in GRAFFER gr_2df_plot, pdefs, i Argument: pdefs struct input The Graffer control structure. i int input Which
GR_ANG_PTS GR_ANG_PTS Get all the points of polar dataset (with possible error bars) gr_ang_pts, xydata, ndata, type, r, t Arguments xydata float input The data array. ndata int input The numer of values in it.
GR_APPEND GR_APPEND Append one dataset to another optionally deleting the appended gr_append, pdefs, n1, n2[, /delete, /sort] Arguments: pdefs struct in/out The GRAFFER data structure. n1 int input The index number of the appendee.
GR_APP_W Menu to control GR_APPEND gr_app_w, pdefs Argument: pdefs struct in/out The GRAFFER data structure Original: 12/11/96; SJT Shorten name: 25/11/96; SJT
GR_ASC_SAVE GR_ASC_SAVE Save a graffer dataset to a file gr_asc_save, pdefs Argument: pdefs struct input The graffer data structure. Original: 16/8/95; SJT
GR_AS_XA Autoscale graffer data (X-Axis, rectangular plot) gr_as_xa, data, range Arguments: data struct input The Graffer data structure (extracted from PDEFS) xrange float input The x- range for functions (th=f(r))
GR_AS_XR Autoscale graffer data (X-Axis, rectangular plot) gr_as_xr, data, range Arguments: data struct input The Graffer data structure (extracted from PDEFS) yrange float input The Y- range for functions (x=f(y))
GR_AS_YA Autoscale graffer data (Y-Axis, rectangular plot) gr_as_ya, data, range Arguments: data struct input The Graffer data structure (extracted from PDEFS) xrange float input The x- range of plot for functions th=f(r))
GR_AS_YR Autoscale graffer data (Y-Axis, rectangular plot) gr_as_xr, data, range Arguments: data struct input The Graffer data structure (extracted from PDEFS) xrange float input The X- range for functions (y=f(x))
GR_AUTOSCALE GR_AUTOSCALE Autoscale a GRAFFER axis to its data. gr_autoscale, pdefs, [/xaxis|/yaxis] Arguments: pdefs struct in/out The GRAFFER data structure Keywords:
GR_AUTO_DELETE GR_AUTO_DELETE Delete a GRAFFER autosave file. gr_auto_delete, pdefs Argument: pdefs struct input The GRAFFER data structure. Original (out of GRAFF_EVENT): 9/10/96; SJT
GR_AXIS_MENU GR_AXIS_MENU Make up an axis options menu for GRAFFER gr_axis_menu, axis, base, pdefs Arguments: axis char input "X" or "Y" to say which axis it is. base long input Widget ID of the parent base.
GR_BIN_DS GR_BIN_DS Read an individual dataset from a binary V2.x GRAFFER file. Arguments: data struct in/out The graffer dataset structure nset int input The serial number of the current dataset.
GR_BIN_SAVE GR_BIN_SAVE Save a graffer dataset to a file in binary format gr_bin_save, pdefs Argument: pdefs struct input The graffer data structure. auto input If set & non-zero, then this is an
GR_BIN_TXT GR_BIN_TXT Read an individual Text string from a binary V2.x GRAFFER file. Arguments: text struct in/out The graffer text string structure nset int input The serial number of the current dataset.
GR_BYT_RD GR_BYT_RD Read byte value(s) from a binary GRAFFER file val = gr_byt_rd(ilu, nvals) Return value: val byte The required byte Arguments:
GR_BYT_VAL GR_BYT_VAL Return byte value associated with a tag Return value: value byte The value associated with the tag. Arguments: tag_val string input The string containing the tag value.
GR_CF_PIECES GR_CF_PIECES A Procedure interface to GR_PIECES to keep CURVEFIT happy! As we don't know which will get called first they have to be in separate files!
GR_CHECK_BOX GR_CHECK_BOX Read the bitmap for the checkbox image. bitmap=gr_check_box(nx,ny) Return Value: bitmap byte The bitmap Arguments:
GR_COMMENT GR_COMMENT Add a "general" comment to the plot file. This comment is not displayed anywhere, it's just an arbitrary piece of text for you to use as you wish. ichange=gr_comment(pdefs) Argument:
GR_CONTROL_MENU GR_CONTROL_MENU Make the main control menu for graffer. gr_control_menu, base Argument: base long input The widget ID of the parent base. Extracted from GRAFFER (& Help button added for X): 18/12/96;
GR_CONT_MENUS GR_CONT_MENU Make the menu to set the properties of a contoured ds. gr_cont_menu, pdefs, data Arguments: pdefs struct input The Graffer data & control structure. data struct in/out The data structure extracted from pdefs
GR_DISPLAY_IMG GR_DISPLAY_IMG Colour/greyscale image display for GRAFFER gr_display_img, zin, xin, yin, range=range, $ colour_range=colour_range pixel_size=pixel_size Arguments: zin float input The data to be displayed
GR_DISP_MAN GR_DISP_MAN gr_disp_man initialise input If set & non-zero, then initialize the system otherwise display help. Original: 19/12/96; SJT Modify reading of help file to speed it up: 18/3/97; SJT
GR_DS_CREATE GR_DS_CREATE Make the pulldown menu to define &| edit a dataset. gr_ds_create, base Argument: base long input The ID of the parent base Pulled out of GRAFFER: 9/12/96; SJT
GR_DS_MENUS GR_DS_MENUS Make the menu to set the properties of an XY dataset gr_ds_menus, optbb, pdefs Arguments: optbb long input The widget ID of the parent base pdefs struct in/out The Graffer data & control structure.
GR_DS_PULLDOWN GR_DS_PULLDOWN Dataset selection pulldown gr_ds_pulldown, base Argument: base long input The ID of the parent base. Extracted from GRAFFER: 9/12/96; SJT
GR_FILE_EXIST GR_FILE_EXIST Checks if a file exists (is readable). ok = gr_file_exist(file) Return value: ok int 1 if the file exists, 0 if it doesn't. Argument:
GR_FIT_DSET GR_FIT_DSET Select a data set to do a least-squares fit. ichange = graff_ch_dset(pdefs) Return value: ichange int 1 if the DO button was used, 0 if cancel Argument:
GR_FIT_FUNCT GR_FIT_FUNCT Make a least squares fit to a dataset gr_fit_funct, pdefs Argument: pdefs struct in/out The GRAFFER plot structure. Original: 28/8/96; SJT
GR_FLT_RD GR_FLT_RD Read float value(s) from a binary GRAFFER file val = gr_flt_rd(ilu, nvals) Return value: val float The required float Arguments:
GR_FLT_VAL GR_FLT_VAL Return floating point value associated with a tag Return value: value float The value associated with the tag. Arguments: tag_val string input The string containing the tag value.
GR_FRA2NORM GR_FRA2NORM Convert "Frame" coordinates to normalized coordinates gr_fra2norm, xf, yf, xn, yn Arguments: xf, yf float input X & Y coordinates in "Frame" system xn, yn float output X & Y coordinates in normalized
GR_FUN_READ GR_FUN_READ Get a function from a data file ichange = gr_fun_read(pdefs) Return value: ichange int 1 if the DO button was used, 0 if cancel Argument:
GR_GET_ASC GR_GET_ASC Get an ASCII graffer dataset from a file iopen = gr_get_asc(pdefs[, f]) Return Value: iopen int 1 If file was opened; 0 if not. Argument:
GR_GET_BIN GR_GET_BIN Get an BINARY graffer dataset from a file iopen = gr_get_bin(pdefs[, f]) Return Value: iopen int 1 If file was opened; 0 if not. Argument:
GR_GET_DS GR_GET_DS Read an individual dataset from a V2.x GRAFFER file. Arguments: data struct in/out The graffer dataset structure nset int input The serial number of the current dataset.
GR_GET_FULL_DIR GR_GET_FULL_DIR Get the full pathname of a directory path = gr_get_full_dir(dir) Return value: path string The full pathname of the specfied directory Argument:
GR_GET_TXT GR_GET_TXT Read an individual Text string from a V2.x GRAFFER file. Arguments: text struct in/out The graffer text string structure nset int input The serial number of the current dataset.
GR_GET_V1 GR_GET_V1 Get a V1.x graffer dataset from a file graff_get, pdefs, ilu Arguments: pdefs struct in/out The graffer data structure. ilu long input The unit number from which to read.
GR_HARDOPTS GR_HARDOPTS Set hardcopy options gr_hardopts, h ; Not intended for direct user usage Arguments: h struct in/out The hardcopy options. leader long input Group leader of the widget
GR_IMG_MENUS GR_IMG_MENUS Menu for setting options for "IMAGE" format display. gr_img_menus, pdefs, data Arguments: pdefs struct input The Graffer data & control structure. data struct in/out The data structure extracted from pdefs
GR_INT_RD GR_INT_RD Read int value(s) from a binary GRAFFER file val = gr_int_rd(ilu, nvals) Return value: val int The required int Arguments:
GR_INT_VAL GR_INT_VAL Return int value associated with a tag Return value: value int The value associated with the tag. Arguments: tag_val string input The string containing the tag value.
GR_ISADIR GR_ISADIR Checks if its argument is a directory. ok = gr_isadir(dir) 1 if it is, 0 if it isn't or isn't accessible by the user Argument: dir string input The putative directory to be tested
GR_KEY_DEF GR_KEY_DEF Define the plotting of a key on the plot. ichange = gr_key_def(pdefs) Return value: ichange byte Flag indicating if change has been made Argument:
GR_LON_RD GR_LON_RD Read long value(s) from a binary GRAFFER file val = gr_lon_rd(ilu, nvals) Return value: val long The required long Arguments:
GR_LON_VAL GR_LON_VAL Return long value associated with a tag Return value: value long The value associated with the tag. Arguments: tag_val string input The string containing the tag value.
GR_MK_PLMENUS GR_MK_PLMENUS Make the panel for graffer's general plot settings gk_mk_plmenus, base, pdefs Arguments: base long input The ID of the parent widget. pdefs struct in/out The graffer control structure.
GR_OPT_SET GR_OPT_SET Set GRAFFER special options, e.g updating state etc. gr_opt_set, pdefs Argument: pdefs struct in/out The ubiquitous GRAFFER structure. Original: 4/7/97; SJT
GR_OVERWRT GR_OVERWRT Do you want to overwrite an existing file? gr_overwrt, pdefs pdefs struct input The graffer structure, needed if save requested. default int input Which button to give the focus: 0 -
GR_PIECES GR_PIECES A piecewise straight line routine. y = gr_pieces(x, a) Return Value: y float The value of the function at the given X values.
GR_PLACE_WINDS GR_PLACE_WINDS Adjust the positioning of the two windows in comapct mode so they are reasonable well separated. gr_place_winds, pdefs Argument: pdefs struct input The GRAFFER master structure.
GR_PLOT_OBJECT GR_PLOT_OBJECT Plots the plot specified by pdefs gr_plot_object, pdefs ; Not intended to be used directly by ; the user Argument: pdefs struct input The structure containing the plot
GR_PL_AXES GR_PL_AXES Plot axes for GRAFFER gr_pl_axes, pdefs, csiz[, /overlay] Argument: pdefs struct input The ubiqitous GRAFFER control structure
GR_PL_KEY GR_PL_KEY Plot a key to the plot. gr_pl_key, pdefs, csiz Argument: pdefs struct input The ubiquitous GRAFFER data & control structure
GR_PL_TEXT GR_PL_TEXT Plot text string in GRAFFER. gr_pl_text, text, csiz[, /no_null] Arguments: text struct input A GRAFFER text structure. csiz float input The character size to use as a
GR_POL_RECT GR_POL_RECT Convert polar to rectangular coordinates. gr_pol_rect, r, th, x, y Arguments: r float input The radial coordinate th float input The angular coordinate (radians)
GR_POSITION GR_POSITION Set the position of the corners of the plot ichange = gr_position(pdefs) Return value: ichange byte Flag indicating if change has been made Argument:
GR_PSYM_BITM GR_PSYM_BITM Define the bitmaps for the PSYM menu. gr_psym_bitm Original: 1/8/95; SJT Add byte-swap for little-endian machines: 7/8/96; SJT - following a suggestion from Christian Marquardt.
GR_PWFIT Control use of CURVEFIT to make a piecewise linear fit to the fit = gr_pwfit(x, y, w, nsg, c2) Return Value: fit float The fitted funtion expressed in terms of the GR_PIECES function Arguments:
GR_RC_GET GR_RC_GET Read the user's .grafferrc file. gr_rc_get, opts Argument: opts struct output The graffer options sub-structure. This is a procedure rather than a function as functions tend
GR_RECOVER GR_RECOVER Ask about options for recovery if requested mode and apparent best option don't match. icont = gr_recover(imode) Return value: 1 -> Use the autosave file
GR_RESAVE GR_RESAVE Do you want to resave a V1 file as V2 gr_resave, pdefs pdefs struct input The graffer structure, needed if save requested. Original (from GRAFF_S_PROMPT): 5/11/96; SJT
GR_SPLIT_DIR GR_SPLIT_DIR Separate a file name into a directory and a file name. gr_split_dir, file, dir Arguments: file string in/out On entry the full filename, on exit the filename part.
GR_STATE Restore the entry state of graffer. gr_state[, id] Argument: id long input Widget ID of the widget invoking gr_state. This routine is intended to operate as a "KILL_NOTIFY"
GR_STR_FUN GR_STR_FUN Given a set of coefficients and a variable return an IDL fun = gr_str_fun(fit, var) Return value: fun string The polynomial as a string suitable for EXECUTE
GR_STR_PUT GR_STRPUT Put a tag and string value to a binary GRAFFER file gr_str_put, ilu, tag, str Argument: iunit int input The IDL file unit number tag string input The tag for the string
GR_STR_RD GR_STR_RD Read a string value from a binary GRAFFER file str = gr_str_rd(ilu) Return value: str string The required string Argument:
GR_STR_VAL GR_STR_VAL Return string value associated with a tag Return value: value string The value associated with the tag. Arguments: line string input The string containing the tag
GR_SYMDEF GR_SYMDEF User USERSYM to define the GRAFFER symbols that aren't part of the standard IDL set. gr_symdef, index Argument: index int input The symbol index (8->n)
GR_TD_MODE GR_TD_MODE Swap between text and draw modes of the mouse gr_td_mode, value, pdefs Arguments: value int input The mode (0 = draw, 1 = text) pdefs struct input The GRAFFER control structure
GR_TIME_FMT GR_TIME_FMT Formatter for X-axis to display in time values. plot, t, y, xtickformat='gr_time_fmt' ; To do the labelling gr_time_format, axis, options=options, range=range ; initialize Return Value: A string with the time in it.
GR_TLV_Z Construct a graffer data set from top-level variables ichange = gr_tlv_z(pdefs) Return value ichange int 1 if changed, 0 if not Argument: pdefs struct in/out The graffer control/data structure
GR_TM_OPTS GR_TM_OPTS Set time labelling options Shorten name: 25/11/96; SJT Add CAPTURE key to text inputs: 6/2/97; SJT
GR_WRITE_DS GR_WRITE_DS Write the current data set to a file in a format that can be reread by the data from file options. gr_write_ds, pdefs, file Arguments: pdefs struct input The GRAFFER data structure
GR_XY_READ GR_XY_READ Get a plot from a data file ichange = gr_xy_read(pdefs) Return value ichange int 1 if file read, 0 if not Argument:
GR_XY_WID GR_XY_WID Input or edit x & y values for Graffer ichange = gr_xy_wid(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
GR_Z_MENUS GR_Z_MENUS Defines the menus for options for 2-D datasets. gr_z_menus, optbb, pdefs Arguments: optbb long input The widget ID of the parent base pdefs struct in/out The Graffer data & control structure.
GR_Z_READ GR_Z_READ Get a plot from a data file ichange = gr_z_read(pdefs) Return value ichange int 1 if changed, 0 if not Argument:
PICKFILE This function allows the user to interactively pick a file. A file selection tool with a graphical user interface is created. Files can be selected from the current directory or other directories.