M_MATVIEW(3)

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.