b = image_name.captureSignature(ʃmessageʅ);
The
Image.captureSignature function allows the drawing of a signature and stores the captured signature in the
Image object. This function only works on Android devices. The signature UI includes two options:
- Save: Tap to save an image of the displayed signature.
- Clear: Tap to to clear the displayed signature.
The optional string expression message will appear on the Android device's screen while the signature screen is active. The string will not be saved to the image.
The function returns a logical value of 1 (
true) if a signature was successfully captured and 0 (
false) if there was an error capturing a signature or if the operator canceled the operation.
PROC CONSENT
// have the respondent sign to confirm that they agreed to this interview
string consent_filename = Path.concat("Consent Signatures", key(SURVEY_DICT) + ".png");
// if the file exists, then they must have already consented on a previous
// household visit so only take the signature if the file does not exist
if not fileexist(consent_filename) then
string consent_message = "Please sign your name, indicating that you consent to be interviewed for this survey.";
Image consent_signature;
if not consent_signature.captureSignature(consent_message) then
errmsg("The respondent must consent before you can continue.");
reenter;
endif;
consent_signature.save(consent_filename);
endif;