1. I have been perpetually confused about the set echo command. Every time I use it I have been befuddled and frustrated. Finally today I think I understand it. What I missed all these years is that TOP, MIDDLE, and BOTTOM are echo IDs. You do state this in one place but it is not "out front" and not what I expected. My expectation has been that "TOP LEFT" and "TOP RIGHT" could have two separate texts, and that one could do "set echo myecho top left". All wrong. So I suggest that you put the following paragraph below the table under "set echo":
TOP, MIDDLE, and BOTTOM are predefined echo IDs. Adding LEFT, CENTER, or RIGHT as in "set echo MIDDLE CENTER" specifies an alignment for each of these three predefined echo IDs. You cannot have two separate echos that use the single predefined TOP ID. Thus, after "set echo top left", if you "set echo top right" it will move the echo text in the TOP ID to the right, rather than creating a position for separate text. Further, "set echo myecho top" makes no sense -- you cannot use TOP as a position for an echo with an ID (myecho). Instead, you could "set echo mytopright 100% 100%". This creates a separate echo from "set echo top left" which is aligned to the top right. The two echos have IDs "top" and "mytopright". If you want to right-align multi-line text in "mytopright", you also need "set echo mytopright right".
2. Under "set echo NONE" please add:
See also the "Default settings" paragraph above.
3. In the "set echo" table, in the row for "TOP, MIDDLE, BOTTOM", I would reword as follows:
Predefined 2D position echo IDs for quick placement of text. Each of these three special predefined echo ID's can only have one of three predefined alignments: LEFT, CENTER, or RIGHT.
(The existing description for comparison:
Three special 2D positions are also defined for quick placement of text. These three special echos can only have one of three predefined positions: LEFT, CENTER, or RIGHT.)
4. In the doc section "label or labels" I suggest adding a new subsection, below. Recently I wanted to attach a label to the average position of a group of atoms, and after reading the "label" section carefully, I gave up. It never occurred to me to look under "echo"!
Label positioning
Each label is attached to an atom. The position of a label relative to the center of its atom can be adjusted with "set labelAlignment" and "set labelOffset". If you want to position text at the average position of a group of atoms (or drawn objects, or an arbitrary x,y,z position), it can be done with echo: please see "set echo id {x y z}" and "set echo id { [atom-_expression_] }".
Jmol rocks! -Eric
------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________ Jmol-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/jmol-users
