VgaGames4

VgaGames4 - canvas man-pages

[.. upper level ..]

# vg4->canvas->reload()

Reload canvas with actual variable-values.

SYNTAX
VG_BOOL vg4->canvas->reload(struct VG_Canvas *cvas, struct VG_Hash *hvar)
FUNCTION PARAMETERS

cvas | Canvas
hvar | Hash with variable-values for text control-commands "var" and for "$(<varname>)", or NULL hash-format: - key: variable name - value: variable value (string-value) Hash will be copied, therefore may be freed after function call

RETURN VALUE
Returns boolean: - VG_TRUE: OK - VG_FALSE: Error
DESCRIPTION
Reload canvas with actual variable-values. Every time the canvas is executed with vg4->canvas->exec() the variables in hvar passed to vg4->canvas->load() will be used. If the variable-values shall be modified, an actualized hvar must be passed. This is done by vg4->canvas->reload().
SEE ALSO
vg4->canvas->load()