Mercurial > octave-dspies
view doc/interpreter/gui.txi @ 19010:3fb030666878 draft default tip dspies
Added special-case logical-indexing function
* logical-index.h (New file) : Logical-indexing function. May be called on
octave_value types via call_bool_index
* nz-iterators.h : Add base-class nz_iterator for iterator types. Array has
template bool for whether to internally store row-col or compute on the fly
Add skip_ahead method which skips forward to the next nonzero after its
argument
Add flat_index for computing octave_idx_type index of current position (with
assertion failure in the case of overflow)
Move is_zero to separate file
* ov-base-diag.cc, ov-base-mat.cc, ov-base-sparse.cc, ov-perm.cc
(do_index_op): Add call to call_bool_index in logical-index.h
* Array.h : Move forward-declaration for array_iterator to separate header file
* dim-vector.cc (dim_max): Refers to idx-bounds.h (max_idx)
* array-iter-decl.h (New file): Header file for forward declaration of
array-iterator
* direction.h : Add constants fdirc and bdirc to avoid having to reconstruct
them
* dv-utils.h, dv-utils.cc (New files) :
Utility functions for querying and constructing dim-vectors
* idx-bounds.h (New file) :
Utility constants and functions for determining whether things will overflow
the maximum allowed bounds
* interp-idx.h (New function : to_flat_idx) : Converts row-col pair to linear
index of octave_idx_type
* is-zero.h (New file) : Function for determining whether an element is zero
* logical-index.tst : Add tests for correct return-value dimensions and large
sparse matrix behavior
author | David Spies <dnspies@gmail.com> |
---|---|
date | Fri, 25 Jul 2014 13:39:31 -0600 |
parents | 9aff1c9fd70f |
children |
line wrap: on
line source
@c Copyright (C) 2012-2013 Rik Wehbring @c @c This file is part of Octave. @c @c Octave is free software; you can redistribute it and/or modify it @c under the terms of the GNU General Public License as published by the @c Free Software Foundation; either version 3 of the License, or (at @c your option) any later version. @c @c Octave is distributed in the hope that it will be useful, but WITHOUT @c ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or @c FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License @c for more details. @c @c You should have received a copy of the GNU General Public License @c along with Octave; see the file COPYING. If not, see @c <http://www.gnu.org/licenses/>. @node GUI Development @chapter GUI Development Octave is principally a batch or command-line language. However, it does offer some limited features for constructing graphical interfaces for interacting with users. The GUI elements available are I/O dialogs and a progress bar. For example, rather than hardcoding a filename for output results a script can open a dialog box and allow the user to choose a file. Similarly, if a calculation is expected to take a long time a script can display a progress bar. Several utility functions make it possible to store private data for use with a GUI which will not pollute the user's variable space. Finally, a program written in Octave might want to have long term storage of preferences or state variables. This can be done with user-defined preferences. @menu * I/O Dialogs:: * Progress Bar:: * GUI Utility Functions:: * User-Defined Preferences:: @end menu @node I/O Dialogs @section I/O Dialogs Simple dialog menus are available for choosing directories or files. They return a string variable which can then be used with any command requiring a file name. @DOCSTRING(uigetdir) @DOCSTRING(uigetfile) @DOCSTRING(uiputfile) @node Progress Bar @section Progress Bar @cindex Progress Bar @DOCSTRING(waitbar) @node GUI Utility Functions @section GUI Utility Functions These functions do not implement a GUI element but are useful when developing programs that do. @strong{Warning:} The functions @code{uiwait}, @code{uiresume}, and @code{waitfor} are only available for the FLTK tooolkit. @DOCSTRING(desktop) @DOCSTRING(guidata) @DOCSTRING(guihandles) @DOCSTRING(isguirunning) @DOCSTRING(uiwait) @DOCSTRING(uiresume) @DOCSTRING(waitfor) @node User-Defined Preferences @section User-Defined Preferences @DOCSTRING(getpref) @DOCSTRING(setpref) @DOCSTRING(addpref) @DOCSTRING(rmpref) @DOCSTRING(ispref) @DOCSTRING(prefdir) @DOCSTRING(preferences)