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 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()