js9Regions.js

/*
 *
 * js9Regions: Node-based js9 to ds9 region converter
 *
 * Principals: Eric Mandel
 * Organization: Harvard Smithsonian Center for Astrophysics, Cambridge MA
 * Contact: saord@cfa.harvard.edu
 *
 * Copyright (c) 2017 Smithsonian Astrophysical Observatory
 *
 */

/* global require process */
/* eslint no-console: "off" */

"use strict";

// modules
const fs = require("fs");
const argv = require('minimist')(process.argv.slice(2));

// add to ds9 comment string
const addComment = function(comment, key, val){
    if( comment !== "" ){
	comment += " ";
    }
    if( val === true ){
	val = 1;
    }
    if( val === false ){
	val = 0;
    }
    if( key ){
	if( key !== "dashlist" && typeof val === "string" ){
	    val = "{" + val + "}";
	}
	comment += key + "=" + val;
    } else {
	comment += val;
    }
    return comment;
};

// parse region, convert from js9 to ds9
const parseRegion = function(s){
    let json=null;
    let highlite="";
    let comment="";
    const fontarr = [];
    const optsrexp = /(\{.*\})/;
    const comrexp  = /#(?![a-zA-Z0-9]{6}['"])/;
    // split on comment (ignore color specifications starting with '#')
    const sarr = s.trim().split(comrexp);
    // this is the region or command
    const cmd = sarr[0].replace(optsrexp, "").trim();
    // look for json opts after the argument list
    const jarr = optsrexp.exec(sarr[0]);
    if( jarr && jarr[0] ){
	// convert to object
	try{ json = JSON.parse(jarr[0].trim()); }
	catch(e){ json = null; }
    }
    // look for comments
    if( sarr[1] ){
	if( sarr[1].match("=") ){
	    // ds9 comments using key=val (leave as a comment)
	    comment = sarr[1].trim();
	} else {
	    // js9 comment containing tags (convert to series of tags)
	    const carr = sarr[1].split(",");
	    for(let i=0; i<carr.length; i++){
		const c = carr[i].trim();
		if( (c === "source")  || (c === "background") ){
		    comment = addComment(comment, null, c);
		} else if( (c !== "include") && (c !== "exclude") ){
		    comment = addComment(comment, "tag", c);
		}
	    }
	}
    }
    // convert js9 json t ds9 comments
    for(const key in json){
	if( json.hasOwnProperty(key) ){
	    switch(key){
	    case "color":
		comment = addComment(comment, "color", json[key]);
		break;
	    case "strokeDashArray":
		comment = addComment(comment, "dash", 1);
		comment = addComment(comment, "dashlist", json[key].join(" "));
		break;
	    case "strokeWidth":
		comment = addComment(comment, "width", json[key]);
		break;
	    case "removable":
		comment = addComment(comment, "delete", !!json[key]);
		break;
	    case "selectable":
		comment = addComment(comment, "edit", !!json[key]);
		break;
	    case "rotatable":
		comment = addComment(comment, "rotate", !!json[key]);
		break;
	    case "resizable":
		comment = addComment(comment, "resize", !!json[key]);
		break;
	    case "zoomable":
		comment = addComment(comment, "fixed", !!json[key]);
		break;
	    case "fontFamily":
		fontarr[0] = json[key];
		break;
	    case "fontSize":
		fontarr[1] = json[key];
		break;
	    case "fontWeight":
		fontarr[2] = json[key];
		break;
	    case "fontStyle":
		fontarr[3] = json[key];
		break;
	    case "hasControls":
	    case "hasBorders":
	    case "hasRotatingPoint":
		if( !highlite ){
		    highlite = !!json[key];
		}
		break;
	    case "text":
		comment = addComment(comment, "text", json[key]);
		break;
	    case "tags": {
		const tarr = json[key].split(",");
		for(let i=0; i<tarr.length; i++){
		    comment = addComment(comment, "tag", tarr[i].trim());
		}
		break;
	    }
	    }
	}
    }
    if( cmd ){
	let ostr = cmd;
	if( fontarr.length === 4 ){
	    comment = addComment(comment, "font", fontarr.join(" "));
	}
	if( highlite !== "" ){
	    comment = addComment(comment, "highlite", highlite);
	}
	if( comment !== "" ){
	    ostr += " # " + comment;
	}
	console.log(ostr);
    }
};

// main routine
const convertRegion = function(s){
    const seprexp = /\n|;/;
   // get individual lines (new-line or semi-colon separated)
    const lines = s.split(seprexp);
    // for each region or cmd
    for(let i=0; i<lines.length; i++){
	const line = lines[i].trim();
	if( line && line.substr(0,1) !== "#" ){
	    parseRegion(line);
	}
    }
};

// required args: region file
if( !argv.r || (typeof argv.r !== "string") ){
    console.error("ERROR: no JS9 region file specified");
    process.exit(1);
}
fs.readFile(argv.r, 'ascii', (err, data) => {
    if( err ){
	const s = "ERROR: reading " + argv.r + ": " + err.message;
	console.error(s);
	process.exit(2);
    }
    convertRegion(data);
    process.exit(0);
});