15.3.3.8补丁对象属性

的属性patch对象(详见色斑):

类别:

回调执行 | 颜色和透明度 | 坐标数据 | 创建/删除 | 显示 | 图例参数 | 照明 | 符号外观 | 鼠标交互 | 对象标识 | 轮廓外观 | 父级对象/子级对象 

回调执行

广告
busyaction: "cancel" | {"queue"}

定义Octave在无法中断另一个对象正在执行的回调时如何处理此对象回调属性的执行。只有当当前执行的回调对象具有interruptible属性设置为"off"这里的busyaction中断回调对象的属性指示中断回调是否排队("queue"(默认))或舍弃("cancel").详见回调部分 .

广告
interruptible: "off" | {"on"}

指定此对象的回调函数是否会被其他回调中断。默认情况下interruptible"on"以及使用的回调drawnow, figure, waitfor, getframepause函数最终被中断。详见回调部分 .

广告

颜色和透明度

广告
alphadatamapping: "direct" | "none" | {"scaled"}

尚未为补丁对象实现透明度。alphadatamapping未使用。

广告
cdata: scalar | matrix | array, def. [](0x0)

定义相对于其x/y/z坐标数据的补丁对象颜色的数据。补丁颜色可以使用当前颜色图的索引来定义,也可以定义为RGB三元组,其中RGB颜色是沿着第三维度定义的。这些颜色可以分别为整个补丁对象、各个面或各个顶点定义,并从的形状决定"cdata"如下所示:

如果"cdata"是当前颜色图的标量索引或1乘1乘3的RGB三元组,它定义所有面和边的颜色。

如果补丁对象有N个面,并且"cdata"是颜色图索引的1乘N向量或1乘N乘3 RGB数组,它定义了每个人脸的颜色。

如果补丁对象每个面有N个面和M个顶点,并且cdata是颜色图索引的M×N矩阵或M×N×3 RGB数组,它定义每个顶点的颜色。(的形状"cdata"应该与的匹配"xdata", "ydata""zdata".)

广告
cdatamapping: "direct" | {"scaled"}

设置从map数据的方法"cdata""cdata"属性设置为当前颜色图。"Direct"map使用选择颜色"cdata""facevertexcdata"值作为当前颜色图的索引。"Scaled"map缩放"cdata""facevertexcdata"值到中指定的范围"clim"axes属性 .

广告
facealpha: scalar | "flat" | "interp", def. 1

补丁对象面的透明度级别。目前仅支持double值,其中值0表示完全透明,值1表示没有透明度的实体面。将属性设置为"flat""interp"导致面不被渲染。此外,面没有从后向前排序,这可能会在渲染分层透明面时导致意外的结果。

广告
facecolor: {colorspec} | "none" | "flat" | "interp", def. [0 0 0]

补丁对象面的颜色,指定为有效的颜色规范或"none", "flat""interp". "flat""interp"将为每个面设置单一颜色,或使用存储在"cdata""facevertexcdata"属性。详见颜色规格.

广告
facelighting: {"flat"} | "gouraud" | "none" | "phong"

当设置为其他值时"none",使用灯光和阴影效果绘制对象的面。支持的值为"none"(没有照明效果),"flat"(多面外观),以及"gouraud"(顶点之间的照明效果的线性插值)。"phong"已弃用,其效果与"gouraud".

广告
facevertexalphadata: def. [](0x0)

尚未为补丁对象实现“面顶点”透明度控制。facevertexalphadata未使用。

广告
facevertexcdata: scalar | matrix, def. [](0x0)

定义补丁对象相对于其面顶点数据的颜色的数据。补丁颜色可以使用当前颜色图的索引定义,也可以定义为RGB三元组,其中RGB颜色定义在"facevertexcdata"这些颜色可以分别为整个补丁对象、各个面或各个顶点定义,并且从的形状决定"facevertexcdata"如下所示:

如果facevertexcdata是当前颜色图的标量索引或1乘3的RGB三元组,它定义所有面和边的颜色。

如果补丁对象有N个面,并且facevertexcdata是索引的N乘1列向量或N乘3 RGB矩阵,它定义了N个面中每个面的颜色。

如果补丁对象具有M个顶点,并且facevertexcdata是索引的M乘1列向量或M乘3 RGB矩阵,它定义每个顶点的颜色。

广告

坐标数据

广告
faces: vector | matrix, def. [1 2 3]

补丁连接列表存储为M x N矩阵,M个面中的每个面从最多N个顶点的行定义,每个元素包含存储在中的顶点的行索引顶点属性 。顶点少于N个的面使用NaN值来填充空的行元素。

广告
vertices: vector | matrix, def. 3-by-2 double

补丁顶点列表存储为N x 3矩阵,每行包含向量的x、y和z坐标,并与一起使用faces属性 以定义补丁结构体。

广告
xdata: vector | matrix, def. [0; 1; 0]

补丁顶点x坐标。

广告
ydata: vector | matrix, def. [1; 1; 0]

补丁顶点y坐标。

广告
zdata: vector | matrix, def. [](0x0)

补丁顶点z坐标。

广告

创建/删除

广告
beingdeleted: {"off"} | "on"

属性,指示函数已启动对象的删除。beingdeleted设置为true,直到对象不再存在为止。

广告
createfcn: string | function handle, def. [](0x0)

在创建补丁后立即执行回调函数。函数是通过使用根对象的默认属性来设置的,例如set (groot, "defaultpatchcreatefcn", 'disp ("patch created!")').

有关如何编写图形监听器函数的信息,详见回调部分 .

广告
deletefcn: string | function handle, def. [](0x0)

在删除补丁之前立即执行回调函数。

有关如何编写图形监听器函数的信息,详见回调部分 .

广告

显示

广告
clipping: "off" | {"on"}

如果clipping"on",将在其父轴限制中剪裁补丁。

广告
visible: "off" | {"on"}

如果visible"off",补丁不会在屏幕上渲染。

广告

图例参数

广告
displayname: def. ""

与此补丁对应的图例分量的文本。

广告

照明

广告
ambientstrength: scalar, def. 0.3000

环境光的强度。值介于0.0和1.0之间。

广告
backfacelighting: "lit" | {"reverselit"} | "unlit"

"lit":法线按原样用于照明。"reverselit":法线始终朝向视点。"unlit":法线指向远离视点的面不发光。

广告
diffusestrength: scalar, def. 0.6000

漫反射的强度。值介于0.0(无漫反射)和1.0(全漫反射)之间。

广告
facenormals: def. [](0x0)

如果edgelightingfacelighting属性设置为"flat"背景facenormals也迫使facenormalsmode属性设置为"manual".

广告
facenormalsmode: {"auto"} | "manual"

如果此属性设置为"auto", facenormals如果edgelightingfacelighting属性设置为"flat"以及至少一个light对象在同一轴上存在并且可见。

广告
specularcolorreflectance: scalar, def. 1

镜面反射颜色的反射率。值介于0.0(基础面的颜色)和1.0(光源的颜色)之间。

广告
specularexponent: scalar, def. 10

镜面反射的指数。该值越低,反射就越分散。

广告
specularstrength: scalar, def. 0.9000

镜面反射的强度。值介于0.0(无镜面反射)和1.0(全镜面反射)之间。

广告
vertexnormals: def. [](0x0)

如果edgelightingfacelighting属性设置为"gouraud"背景vertexnormals也迫使vertexnormalsmode属性设置为"manual".

广告
vertexnormalsmode: {"auto"} | "manual"

如果此属性设置为"auto", vertexnormals如果edgelightingfacelighting属性设置为"gouraud"以及至少一个light对象在同一轴上存在并且可见。

广告

符号外观

广告
marker: "*" | "+" | "." | "<" | ">" | "^" | "_" | "d" | "diamond" | "h" | "hexagram" | {"none"} | "o" | "p" | "pentagram" | "s" | "square" | "v" | "x" | "|"

详见线条符号属性 .

广告
markeredgecolor: {"auto"} | "flat" | "none"

详见线条符号的颜色属性 .

广告
markerfacecolor: "auto" | "flat" | {"none"}

详见线条符号表面颜色属性 .

广告
markersize: scalar, def. 6

详见线条符号化属性 .

广告

鼠标交互

广告
buttondownfcn: string | function handle, def. [](0x0)

有关如何编写图形监听器函数的信息,详见回调部分 .

广告
contextmenu: graphics handle, def. [](0x0)

当前与此补丁对象关联的uicontextmenu对象的图形句柄。

广告
hittest: "off" | {"on"}

指定补丁是处理鼠标事件还是将其传递给对象的祖先。启用后,对象可以通过评估"buttondownfcn",显示uicontextmenu,并最终成为根"currentobject"。只有当对象可以接受从"pickableparts"属性详见pickableparts属性 .

广告
pickableparts: "all" | "none" | {"visible"}

指定补丁是否接受鼠标单击。默认情况下,pickableparts"visible"并且只有补丁的可见部分或其子部分可以对鼠标点击做出反应。当pickableparts"all"可见和不可见部分(或子部分)都可能对鼠标点击做出反应。当pickableparts"none"鼠标在该对象上的点击将被忽略,并传输到该对象下面的任何对象。当对象配置为接受鼠标单击时"hittest"属性将决定如何处理它们。详见hittest属性 .

广告
selected: {"off"} | "on"

属性指示是否选择此补丁。

广告
selectionhighlight: "off" | {"on"}

如果selectionhighlight"on",则补丁的选择状态在视觉上高亮显示。

广告

对象标识

广告
tag: string, def. ""

用于符号图形对象的用户定义字符串。

广告
type (read-only): string

图形对象的类名。type总是"patch".

广告
userdata: Any Octave data, def. [](0x0)

要与图形对象关联的用户定义数据。

广告

轮廓外观

广告
edgealpha: scalar | matrix, def. 1

尚未为补丁对象实现透明度。edgealpha未使用。

广告
edgecolor: colorspec | "none" | "flat" | "interp", def. [0 0 0]

补丁对象边缘的颜色,指定为有效的颜色规范或"none", "flat""interp". "flat""interp"将为每条边设置单一颜色,或使用存储在中的颜色值数据在边的顶点之间插值的颜色"cdata"详见颜色规格.

广告
edgelighting: "flat" | "gouraud" | {"none"} | "phong"

当设置为其他值时"none",使用灯光和阴影效果绘制对象的边缘。支持的值为"none"(没有照明效果),"flat"(多面外观),以及"gouraud"(顶点之间的照明效果的线性插值)。"phong"已弃用,其效果与"gouraud".

广告
linestyle: {"-"} | "--" | "-." | ":" | "none"

详见线条样式.

广告
linewidth: scalar, def. 0.5000

详见线宽属性 .

广告

父级对象/子级对象

广告
children (read-only): vector of graphics handles, def. [](0x1)

尚未为补丁对象实现补丁对象的子对象。children未使用。

广告
handlevisibility: "callback" | "off" | {"on"}

如果handlevisibility"off",补丁的句柄在其父级的中不可见"children"属性

广告
parent: graphics handle

父图形对象的句柄。

广告

版权所有 © 2024-2025 Octave中文网

ICP备案/许可证号:黑ICP备2024030411号-2