<-- Back to AG_Intro.3

SYNOPSIS

#include <agar/core.h>
#include <agar/gui.h>
#include <agar/math/m.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_HFILL	Expand horizontally in parent container.
M_MATVIEW_VFILL	Expand vertically in parent container.
M_MATVIEW_EXPAND	Shorthand 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

HISTORY

The M_Matview widget first appeared in Agar 1.3.4.