设计 Metacity 主题

原文路径：http://blog.csdn.net/c_spark/article/details/2918270

    1.Metacity主题：
    Metacity 主题是基于XML格式的，还有依赖于具体主题的一定数量的图片【通常是便携网络图形格式，PNG】。

    2.如何创建主题：
    要做的第一步是在下面的位置创建一个目录 -
        $PREFIX/share/themes/[theme_name]/metacity-1/
        $HOME/.themes/[theme_name]/metacity-1/
    按照您的主题名字起名。尽管 Metacity 会检测在上面的任一个位置的主题。但是，当您编写和调试之时，置主题于您的家目录下不失为明智之举。

    紧跟着的一步是编辑选定目录中的“metacity-theme-1.xml”文件。此文件包含主题的 XML 描述，该描述依循 DTD描述。当创建新 Metacity 主题时，不要完全从零开始，而是利用已有的主题，这非常有用的。

    格式最开始的几行是这样的
    
    
    
       Atlanta
       Havoc Pennington
       Havoc Pennington, 2002
       September 2, 2002
       Atlanta- a simple theme using Gtk+ default theme
    
      
    

    3.了解主题基础：
    1）窗口
    有六个 Metacity 认可的不同窗框风格
    normal                 普通的上层窗口
    dialog                 对话窗口
    modal_dialog          模态（modal state）对话框窗口，比如，要干预之后用户方可与其父window交互的窗口
    menu                 可钉住的菜单窗口，如剥离菜单
    utility             小的不变的（persistant）实用工具窗口，如 paletde 或工具箱
    border                 不显示任何装饰的窗口，如全屏化的窗口

    2）风格
    对于每一个窗口风格，都需要映射一个“框架风格集合”。每一个“风格设置”就是几个不同“框架状态”的合成物。您需要指定您的风格中每一个框架状态的外观。
    框架状态是由下面这些要素决定：
            窗口是否已获得焦点或者仍未获得
            窗口是否已最大化或者隐藏【或两者】
            窗口是否能够垂直地，水平地，垂直水平地调整大小

    每一个“框架状态”被映射为一个“框架风格”。框架风格被分成两个不同的部分 ——框架“块” 和窗口“按钮”。 
    这个分类使构建 Metacity 主题更为容易。

    3）框架块

    如果您忽略任一个块，那么该块就是空的。Metacity 能够识别下面的挂框架块
    entire_background             最先被描画的窗口的整个框架
    titlebar                     应用程序窗口之上的区域
    titlebar_middle             不包括“边缘”块的标题条区域
    left_titlebar_edge            标题条左侧区域
    right_titlebar_edge         标题条右侧区域
    top_titlebar_edge            标题条顶部区域
    bottom_titlebar_edge         标题条底部区域
    title                         标题区域
    left_edge                     框架左方的边
    right_edge                     框架右方的边
    bottom_edge                 框架底部的边
    overlay                     同entire_background, 但它在最后才被描画


    4）窗口按钮

    Metacity 认可如下窗口按钮
    close         关闭窗口按钮
    maximize       最大化窗口按钮
    minimize      最小化窗口按钮
    menu          菜单按钮

    以及下面的按钮位置    

    left_left_background         指定左边第一个按钮的背景
    left_middle_background       指定左边第二个按钮的背景
    left_right_background          指定左边第三按钮的背景
    right_left_background         指定右边第一个按钮的背景
    right_middle_background        指定右边第二个按钮的背景
    right_right_background      指定右边第三个按钮的背景

    5）Metacity 窗口按钮

    对于每一个窗口按钮，都必需指定在给定的按钮状态号码下是如何显现的。
    Metacity 认可下面的这些按钮状态 
    normal        对于给定的框架状态，正常的按钮如何出现
    pressed        当点击时【使用鼠标】，按钮应该如何出现
    prelight      当获得焦点时，按钮应该如何出现

    6）窗口菜单

    创建主题的最后一步是指定菜单图标。 他们显示下面这些窗口菜单中的项目 -
    close             光标窗口图标
    maximize           最大化窗口图标
    minimize          最小化窗口图标
    unmaximize         取消最大化窗口图标

    以及下面这些与 GtkStateType 相对应的状态
    normal          菜单中通常的菜单图标如何显示
    prelight        菜单项目获得焦点时菜单图标如何显示
    active            菜单项目激活时【如，选中】时菜单图标如何显示
    selected        菜单项目被选时菜单图标如何显示
    insensitive        菜单项目无效时【如，变灰】菜单图标如何显示
           
    4.检测主题

    创建Metacity主题时,使用特别为测试主题而设计的应用程序是可取的， Metacity 主题查看器。要使用这一程序， 只需简单的使您的主题作为参数（argument）来加载 。加载的主题将会得到分析，如果有错，它将通过命令行输出错误信息。修复错误直到主题被成功加载。

    这个应用程序仅在设计窗口装饰风格时有用，因为它显示出来的窗口上的按钮和窗口菜单无法响应你的操作(鼠标点击或键盘事件)。

    切换新主题，需要使用 gconftool-2 或用桌面菜单中的"桌面首选项" > "主题"，然后选择“窗口边框主题”标签。如果使用 gconftool2-，则要采用如下的命令 -
    gconftool-2 --type=string --set /apps/metacity/general/theme [theme_name]

    5.Metacity 框架定义

    1）框架的几何图

    第一件事是需要创建“框架的几何图”，框架几何图的 name 属性，会在后面给定的“框架风格”中涉及到。
    
      
    
    给定几何图中几个可修改的宽度和高度
    Frame geometry specifications
    框架几何图规格说明,框架几何图拥有的一些可选属性
    has_title                     决定在高度计算中是否包含标题文本的高度。缺省值为真。
    title_scale                 使用 Pangomarkup - xx-small, x-small, small, medium, large, x-large and xx-large。缺省使用桌面字体。
    rounded_top_left             定义是否窗口的左上角被圆角化（rounded）。缺省不使用。
    rounded_top_right            定义是否窗口的右上角被圆角化（rounded）。缺省不使用。
    rounded_bottom_left         定义是否窗口的左下角被圆角化（rounded）。缺省不使用。
    rounded_bottom_right        定义是否窗口的右下角被圆角化（rounded）。缺省不使用。

    
      
      
      
      
      
      
      
      
      
      
    

    指定框架几何图时，可以使用继承。然后提供新的属性值来替代继承过来的任意值。
    
      
      
      
      
      
    

    按钮的宽度和高度，可以通过指定某一个比例来替代。
    


    2）描绘运算

    “描绘运算”是设计 Metacity 主题的核心部分。为了能够成功描绘框架各部分，需要为“框架块”指定描绘运算。
    
      
    

    3）运算符

    描绘运算通常是forward declared, 但也可放到一行中【参见后面的例子】。下面是在描绘运算中被允许的运算符列表 -

    运算符        意  义            示 例
    +            加                2 + 3
    -            减                5 - 4
    *            乘                3 * 2
    /            除                10 / 2
    %            模                34 % 3
    `max`       最大值            4 `max` 5       
    `min`       最小值            7 `min` 3
    ()            括号            (5 * 3) + 5

    应该注意的是常规的 precidence 规则对所有的运算符都有效。

    4）常量

    在描绘运算中，可以使用预定义变量或常量。常量需要声明且必须以一个大写字母开头。
    

    下面列表是可以使用的预定义变量
    width                目标区域的宽度
    height                目标区域的高度
    object_width        被描绘物的自然宽度
    object_height       被描绘物的自然高度
    left_width          从左边框架到客户窗口的距离
    right_width         从右边框架到客户窗口的距离
    top_height          从顶部框架到客户窗口的距离
    bottom_height       从底部框架到客户窗口的距离
    mini_icon_width     窗口最小图标的宽度
    mini_icon_height    窗口最小图标的高度
    icon_width          大图标的宽度
    icon_height         大图标的高度
    title_width         标题文本的宽度
    title_height        标题文本的高度

    5）运算
    Metacity 支持下面的描绘“运算”
    line
    从起点 (x1, y1) 到终点(x2, y2)用颜色 color 描绘一线段。颜色可以是颜色名如“blue”，十六进制号码如“#FF0099”或者是来自GTK主题的“gtk:base[NORMAL]”形式的【参见后面的更多例子】。它获得附加的属性 width, dash_on_length 和dash_off_length, 它们缺省值都为“0”。
    

    rectangle
    从起点 (x,y) 和给定的 width 和 height 描绘一个方形。其有一个可选属性 filled, 缺省值是“false”。
    

    arc
    从起点(x,y)和给定的 width, height, start_angle 以及 extent_angle 描绘一段弧线。其有一个可选属性filled,缺省值是“false”。
    

    tint         
    从起点(x,y)和给定的 width, height,着色，color和alpha.
    

    gradient         
    描绘一个渐变从起点(x,y)和给定的width, height, type 【垂直、水平、对角】和一些 color 元素。
    
      
             
    

    image         
    映射一幅图像到元素从起点(x,y)和给定的 width, height and filename。它有可选自变量参数alpha 和 colorize, 缺省值是“0” 和无色彩。
    

    gtk_arrow         
    描绘一个箭头，从起点(x,y)和给定的width, height, GTK state, shadow [无, 内, 外, etched_in 和 etched_out] 和 direction [上, 下, 左或右]。其有可选自变量 filled，缺省值是“false”。
    

    gtk_box         
    描绘一个盒子，从起点(x,y)和给定的width, height, GTK state 和 shadow.
    

    gtk_vline         
    描绘一段垂直线段，从起点(x,y1) 到终点 (x,y2) 和 GTK state.
    

    icon         
    描绘窗口图标，从起点（x,y)和给定的width 和 height。其拥有可选自变量 alpha, 缺省值是“0”。
    

    title         
    描绘窗口标题文本，从起点(x,y)和给定的color.