Style

スタイルについて¶

CueMol2では各レンダラーにさまざまなプロパティーがあって他の分子Viewerに比べて多彩な表現が可能なわけですが，逆にたくさんありすぎて「いちいち設定するのが面倒」という問題がありました．

そこで，スタイルという概念を導入して，プリセット的にプロパティーを一括設定できるようにしました．

現時点(2.0.0.124)では，いくつかのスタイルがシステムで定義されており，それをUIから選んで使用することができるようになっています．

基本的に，スタイルはSceneパネルのレンダラーを右クリックして表示されるコンテキストメニューから指定できます．

例えば，ribbonレンダラーを作成し，コンテキストメニューを表示させると，以下のようなのが出てきますが，

style_ribbon_ctxtmenu1

ここでRoundを選ぶと，ribbon rendererの形状が以下のように変化します．

Ribbon以外にも，ballstick，atomintrなど他のrendererにもいくつかのシステムで定義されたスタイルが適用できるようになっています．

Paint(塗り)に関するスタイルは，形状とは独立に定義されており， Colorパネルから指定できるようになっています．

まず，Colorパネルでスタイルを適用する対象のレンダラーを選び，右横の▼ボタンを押すとドロップダウンメニューが出てきますが，そこから「Paint coloring」を選ぶと図のようにプリセットのスタイルが選択項目として出てきます．

style_paint_ctxtmenu1

現時点ではDefaultとWoodyしかありませんが，Woodyに変えるとCueMol1のデフォルトの着色であった植物風（？）の着色に変化します．

→

以上のように一括して指定できるスタイルですが，いろいろいじっていくうちに，スタイルを指定したのに，場合によっては無視される，という状況が起こるかもしれません．

これは，詳しくは下記の概念的な話で説明していますが，ユーザ指定値でスタイル値が上書きしてされてしまっているためです．

ともかくもスタイルを生かしたかったら，プロパティー設定ダイアログにある Reset all to defaultボタンを押してください．ただしもちろん，ダイアログから個別に指定した値は消えてしまいます．

style_resetall

あるいは上の図のように，プロパティ設定ダイアログのGenericタブには，値ごとにdefaultというチェックボックスがあり，これをONにすることで値をデフォルトに戻す（すなわちスタイルが効くようにする）ことも可能です．

CueMol2のレンダラーなどにはプロパティ（名前と値の組）がありますが，多くのプロパティーにはユーザが特に値を指定していない場合に適用される，デフォルト値というものが存在します．

このデフォルトの値はCueMol2のソースコードレベルで決まってしまっているため，後から変更することはできません．

一方で，レンダラーにスタイルを適用すると，デフォルト値がスタイルで定義されている値に置き換わります．

これを模式的に表した図が，以下になります．

style_concept1

例えば図のwidthの場合，スタイルを全く適用していない場合は，左側のようにDefault valuesにある0.5という値が使用され，その値に応じて表示がおこなわれます．

さらに，（システムで定義されている）スタイルを指定した場合，中央のようにSystem settingsにある0.1という値が使用され，デフォルト値0.5は無視されるようになります．

さらに，プロパティー設定ダイアログで直接値を指定すると(この場合は1.0を指定している)，右側のようにUser specified valuesが使用され，デフォルト値(0.5)，スタイル定義値(0.1)ともに無視され，ユーザ指定値が最優先されるようになります．

システム定義のスタイルは，Windowsでは

<CueMol2フォルダ>\data\default_style.xml

（CueMol2フォルダは，CueMol2インストール先で，たとえばC:\Program Files (x86)\CueMol 2.0など）にあるシステムのスタイル定義ファイルに記述されています．

MacOS Xの場合は，CueMol2.app内にある

<CueMol2.app>/Resources/data/default_style.xml

にあるため，Finderなどからは直接アクセスできませんが，ターミナルなどから見ることが可能です．

この内容を編集すれば新たなスタイルを追加できるわけですが，このファイルはインストール時にインストーラーが上書きして消してしまうため直接編集はお勧めできません．

一方，上の概念図のようにUser-defined, Scene-definedという層がありますが，今後，ユーザインタフェイスからこれらのレベルでユーザーがスタイルを定義し，利用できるようにしていく予定です．