Function parse

src/psimage.c:132–335

}

static int parse (struct GMT_CTRL *GMT, struct PSIMAGE_CTRL *Ctrl, struct GMT_OPTION *options) {
	/* This parses the options provided to psimage and sets parameters in Ctrl.
	 * Note Ctrl has already been initialized and non-zero default values set.
	 * Any GMT common options will override values set previously by other commands.
	 * It also replaces any file names specified as input or output with the data ID
	 * returned when registering these sources/destinations with the API.
	 */

	unsigned int n_errors = 0, ind = PSIMAGE_FGD, k = 0;
	int n;
	char cstring[GMT_LEN256] = {""}, fstring[GMT_LEN256] = {""}, *p = NULL;
	char txt_a[GMT_LEN256] = {""}, txt_b[GMT_LEN256] = {""}, txt_c[4] = {""};
	struct GMT_OPTION *opt = NULL;
	struct GMTAPI_CTRL *API = GMT->parent;

	/* Because of backwards compatibility with deprecated -C optino and upgraded -F option we need to
	 * per-scane for those options and capture their arguments so that later we can handle the backwards
	 * checking without worry about option order. */

	for (opt = options; opt; opt = opt->next) {	/* Process all the options given */
		if (opt->option == 'C') { /* Deprecated */
			GMT_Report (API, GMT_MSG_COMPAT, "-C option is deprecated, use -Dx instead.\n");
			n = sscanf (opt->arg, "%[^/]/%[^/]/%2s", txt_a, txt_b, txt_c);
			sprintf (cstring, "x%s/%s", txt_a, txt_b);	/* Build +x modifier* for -D */
			if (n == 3) {	/* Append modifier +j with given argument */
				strcat (cstring, "+j");
				strcat (cstring, txt_c);
			}
		}
		else if (opt->option == 'F') {	/* Check for deprecated version of -F<pen> */
			if (gmt_M_compat_check (GMT, 5) && opt->arg[0] != '+') { /* Warn but process old -F<pen> */
				GMT_Report (API, GMT_MSG_COMPAT, "The -F<pen> option is deprecated but was accepted. Use -F modifier +p<pen> instead\n");
				sprintf (fstring, "+c0+p%s", opt->arg);	/* Reformat using new syntax */
			}
			else	/* Expected syntax given (we hope) */
				strncpy (fstring, opt->arg, GMT_LEN256-1);
		}
	}

	for (opt = options; opt; opt = opt->next) {	/* Process all the options given */

		switch (opt->option) {

			case '<':	/* Input files */
				n_errors += gmt_M_repeated_module_option (API, Ctrl->In.active);
				n_errors += gmt_get_required_file (GMT, opt->arg, opt->option, 0, GMT_IS_IMAGE, GMT_IN, GMT_FILE_REMOTE, &(Ctrl->In.file));
				break;

			/* Processes program-specific parameters */

			case 'D':
				n_errors += gmt_M_repeated_module_option (API, Ctrl->D.active);
				p = (cstring[0]) ? cstring : opt->arg;	/* If -C was used then cstring was set above */
				if ((Ctrl->D.refpoint = gmt_get_refpoint (GMT, p, 'D')) == NULL) {	/* Failed basic parsing */
					GMT_Report (API, GMT_MSG_ERROR, "Option -D: Basic parsing of reference point in %s failed\n", opt->arg);
					n_errors++;
				}
				else {	/* args are now [+j<justify>][+n<n_columns>[/<n_rows>]][+o<dx>[/<dy>]][+r<dpi>[c]][+[-]<width>] */