NAME

restore_target - Request that the target frameserver session restores from a previously made snapshot.

SYNOPSIS

bool:exist
restore_target( vid:target, string:resource )
restore_target( )
restore_target( vid:target, string:resource, number:namespace )
restore_target( )
restore_target( vid:target, string:resource, number:namespace, string:description )

DESCRIPTION

Open resource from the APPL_STATE_RESOURCE and send to target requesting that it restores its state from the resource. It returns true of the resource was found and sent successfully. If another namespace is provided from the normal set of read- resources, It will be opened read only and sent as a binary chunk. On a pasteboard this action is interpreted as a 'paste' if there is ongoing mouse-drag action on the parent segment, it will be interpreted as a drop. On a segment that announced bchunkstate it will be interpreted as an open operation. If a description is provided, a short (~60ch) text type descriptor of the data can be amended. The convention is to treat this as a simplified MIME - type, with the application/ prefix being the default (and can thus be omitted).

NOTES

1: The namespace is one of the set:
SHARED_RESOURCE , APPL_RESOURCE , APPL_TEMP_RESOURCE
2: It is possible that the target can re-open the descriptor in a write- mode depending on operating system and creative use of primitives.