Documents

What is the Style?

Renderers in CueMol2 have many properties, which enable more various presentations than other molecular viewers. However, it is quite troublesome to setup all of the many properties every time. The mechanism of "Style" implemented in CueMol2 alleviate this problem, by providing a way for the reuse of the renderer property settings. There are two types of the styles, i.e., the system-define styles and the user-defined styles. The system-define styles are defined in the CueMol's system and you are ready to use them without any settings, while you have to define new styles to use the user-defined styles.

How to use the System-defined styles

There are several "system-defined" styles in CueMol, which are useful for quickly changing the renderer's appearance.

Apply shape style to renderer

You can apply the styles related to the shape of the renderers from the context menu of the renderers in the Scene panel. The context menu appears when you right-click the renderer item in the Scene panel. For example, you right-click the ribbon renderer in the Scene panel, you will find the context menu like this:

styles1-fig1-ctxtmenu1.png

In this menu, if you select the "Fancy1" item, the shape of the ribbon renderer will change as shown in the Fig below.

styles1-fig2-fanc1ribbon1.png

You can reset to the original shape by selecting the "Default" item in the context menu. The other renderers (ballstick, atomintr, etc) also have the system-defined styles useful for the quick settings.

Apply paint style to renderer

You can apply the styles related to the painting of the renderers, from the menu in the "Color" panel. After selecting the target renderer by the drop-down list box in the "Color" panel, you will find the color settings of the target renderer. In this panel, by pushing the button at the right side of the drop-down list box (with the triangle icon), the drop-down menus for the coloring types will appear.

styles1-fig3-stylemenu1.png

In this menu, for example, select the "Paint coloring" item and you will find the menus for the coloring styles.

styles1-fig4-stylemenu2.png

In the Woody style, the helices and sheets are colored in brown and green, respectively, as in the default color in CueMol1.

styles1-fig5-style-woody1.png

More detailed setting of styles

You can change the style settings of renderers in more depth by the style dialog. The renderer style dialog will appear by clicking the “Edit styles…” of the context menu of the renderer, which can be displayed by right-clicking the renderer item in the Scene panel

styles1-fig6-editstyle1.png

In this dialog, the name (and type) of the target renderer is shown at the top of the dialog, and the styles currently applied to the target renderer are shown in the list box. There are several tool buttons below the list box. By selecting the style name in the list box and click the “--” button below, you can remove the style from the target renderer. By pushing the “+” button, you can add the other styles to the target renderer.

styles1-fig7-styledlg1.png

If you want to apply the changes made in this dialog, push the “OK” button to close the dialog. If you want to discard the changes, push the “Cancel” button to close the dialog.

Why do my style settings not have effect?!

After playing with the renderer properties, you may find that some style settings do not have effect on the appearance of the renderes displayed in the mol view.

Usually, this would happen when you have overwritten the property values from the property setting dialog, which are also specified by the style settings. For example, if you have changed the section type of the helix of the ribbon renderer to “Elliptical”, and then you applyed the “Fancy1” style from the style context menu as above, you will find that the appearance of the helices do not change to “Fancy” (Molscript-like representation with white inner faces) and still remained “Elliptical” appearance.

So, if you want the style setting take effect, you have to reset the property (e.g., the section type of the helix of the ribbon renderer) to the “default” state. This can be done by turning on the default check button of the corresponding property (e.g., helix.type) in the Generic tab.

style_resetall.png

Otherwise, if you don’t know the names of the properties you changed, you can reset all of the properties of the renderer to the default state by pushing the “Reset all to default” button in the property dialog. (Of course, however, all changes made by the property dialog will be lost.)


Last-modified: Mon, 27 Mar 2017 18:54:06 JST (625d)