Agar

<-- Back to AG_Intro.3

SYNOPSIS

#include <agar/math.h>

DESCRIPTION

The M_Matview widget displays the contents of a M_Matrix(3), either numerically or graphically.

INHERITANCE HIERARCHY

AG_Object(3)-> AG_Widget(3)-> M_Matview.

INITIALIZATION


M_Matview * M_MatviewNew (AG_Widget *parent, M_Matrix *M, Uint flags)

void M_MatviewSizeHint (M_Matview *mv, const char *text, Uint m, Uint n)

void M_MatviewSetMatrix (M_Matview *mv, M_Matrix *M)

void M_MatviewSetDisplayMode (M_Matview *mv, enum m_matview_mode mode)

void M_MatviewSetNumericalFmt (M_Matview *mv, const char *fmt)


The M_MatviewNew() function allocates, initializes, and attaches a new M_Matview widget displaying the matrix M (if not NULL). Acceptable flags include:
M_MATVIEW_HFILLExpand horizontally in parent (equivalent to invoking AG_ExpandHoriz(3)).
M_MATVIEW_VFILLExpand vertically in parent (equivalent to invoking AG_ExpandVert(3)).
M_MATVIEW_EXPANDShorthand for M_MATVIEW_HFILL|M_MATVIEW_VFILL.

M_MatviewSizeHint() sets an initial preferred widget size such that the widget can display m by n cells containing the specified text string.

M_MatviewSetMatrix() changes the matrix currently associated with the widget.

M_MatviewSetDisplayMode() selects the display mode, where mode can be:
enum m_matview_mode {
	M_MATVIEW_GREYSCALE,	/* Graphical rendering (greyscale) */
	M_MATVIEW_NUMERICAL	/* Numerical display */
};

M_MatviewSetNumericalFmt() configures the numerical format (i.e., the printf(3) format string) that will be used to display element values.

EVENTS

The M_Matview widget does not generate any event.

STRUCTURE DATA

For the M_Matview object:
int hSpacing Horizontal spacing between entries
int vSpacing Vertical spacing between entries
int xOffs X display offset (bound to scrollbar)
int yOffs Y display offset (bound to scrollbar)
int scale Scaling factor in graphical mode

SEE ALSO

AG_Intro(3), AG_Widget(3), M_Matrix(3)

HISTORY

The M_Matview widget first appeared in Agar 1.3.4.

Csoft.net ElectronTubeStore.com