NAME

M_Matview — Agar-Math matrix viewer widget

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

SEE ALSO

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

HISTORY

The M_Matview widget first appeared in Agar 1.3.4.