mesh3d(vrmlgen)
mesh3d()所属R语言包：vrmlgen
Draw a 3D-mesh
绘制一个三维网格
译者：生物统计家园网 机器人LoveR
描述----------Description----------
mesh3d visualizes 3D meshes and parametric functions in the VRML- or Livegraphics3D-format.
mesh3d可视化三维网格在的VRML或Livegraphics3D的格式和参数功能。
用法----------Usage----------
mesh3d(xfun = "sin(v)*cos(u)", yfun = "sin(v)*sin(u)",
zfun = "cos(v)", param1 = "u", param2 = "v",
range1 = c(0, 2 * pi), range2 = c(0, pi),
size1 = 30, size2 = 30, type = "vrml", x = NULL,
y = NULL, z = NULL, edges = NULL, obj_infile = NULL,
filename = "out.wrl", write_obj = FALSE, cols = "red",
scalefac = 4, autoscale = ifelse(is.null(obj_infile),
"independent", "equicenter"),
lab.axis = c("X-axis", "Y-axis", "Z-axis"),
col.axis = "black", showaxis = TRUE, col.lab = "black",
col.bg = "white", cex.lab = 1, htmlout = NULL,
hwidth = 1200, hheight = 800,
vrml_navigation = "EXAMINE", vrml_transparency = 0,
vrml_fov = 0.785, vrml_pos = rep(scalefac + 4, 3),
vrml_dir = c(0.19, 0.45, 0.87, 2.45),
lg3d_ambientlight = 0.5)
参数----------Arguments----------
参数：xfun
parametric function to define curves and surfaces (1. dimension)
参数的函数来定义曲线和曲面（1维）
参数：yfun
parametric function to define curves and surfaces (2. dimension)
参数的函数来定义曲线和曲面（2维）
参数：zfun
parametric function to define curves and surfaces (3. dimension)
参数的函数来定义曲线和曲面（3维）
参数：param1
name of the first parameter used in parametric functions
参数函数中使用的第一个参数的名称
参数：param2
name of the second parameter used in parametric functions
第二个参数的函数中使用的参数名称
参数：range1
value range for parameter "param1"
值的范围参数“参数1”
参数：range2
value range for parameter "param2"
参数“param2的值范围”
参数：size1
mesh size for the first parameter used in parametric functions
参数函数中使用的第一个参数的网目尺寸
参数：size2
mesh size for the second parameter used in parametric functions
参数函数中使用的第二个参数的网目尺寸为
参数：type
the output type ("vrml" or "lg3d"), this will be set automatically if mesh3d is called after vrml.open() or lg3d.open()
输出类型（“VRML”或“LG3D”），这将被设置，自动mesh3d被称为，后vrml.open（）或lg3d.open（）
参数：x
a 3-column numeric matrix of coordinates or a numeric vector of x-coordinates (not used if parameter obj\_infile or xfun is specified)
具有3列的数字矩阵的坐标或数字的向量的x坐标（如果不使用参数obj \ _infile或xfun指定）
参数：y
a numeric vector of y-coordinates (only needed if x is a vector)
一个数值向量的y坐标（只需要如果x是一个向量）
参数：z
a numeric vector of z-coordinates (only needed if x is a vector)
一个数值向量的z坐标（如果只需要x是一个向量）
参数：edges
a numerical matrix in which each row contains a sequence of vertex identifiers representing the edges of a polygonal face (vertex identifiers are integer numbers, starting with 0)
的数值矩阵，其中每一行包含一个序列代表一个多边形面的边缘的顶点标识符（顶点的标识符是整数，从0开始）
参数：obj_infile
filename of a 3D mesh input file in obj-format (not required if edges and x,y,z or the parameters for parametric functions are specified)
obj中格式（不是必需的，如果边缘，以及x，y，z或参数被指定为参数函数的三维网格输入文件的文件名）
参数：filename
filename of the generated output file
所生成的输出文件的文件名
参数：write_obj
TRUE, if the output is to be created in the obj-format (requires parameters x,y,z and edges to be set)
TRUE时，如果该输出是在obj格式创建（需要要设置的参数x，y，z和边缘）
参数：cols
the color of the output
输出的颜色
参数：scalefac
a numerical scaling factor to increase/decrease the size of the plotted 3D objects
数值的缩放因子，以增加/减少的大小，绘制3D对象
参数：autoscale
the scaling type. "independent" means all axes are auto-scaled independently. "equidist" means all axes are scaled by the same factor and "equicenter" additionally positions the drawn object in the center. "none" means no scaling is applied
缩放类型。 “独立”是指所有轴自动缩放的独立。 “equidist”意味着所有轴都以相同的系数和的“equicenter”附加地定位在中心绘制的对象的缩放。 “无”表示不进行缩放的应用
参数：lab.axis
a vector of size 3 containing the axis labels
一个向量的大小为3，含有轴标签
参数：col.axis
color of the axis
色的轴
参数：showaxis
if FALSE, the coordinate axes are hidden in the output
如果为false，隐藏坐标轴的输出
参数：col.lab
a vector of colors specifying the axis labels
矢量的颜色指定的轴标签
参数：col.bg
background color
背景颜色
参数：cex.lab
scaling factor for axis label font size
轴标签的字体大小的缩放因子
参数：htmlout
a filename for generating an HTML-file to embed the output
用于产生一个HTML文件的文件名来嵌入输出
参数：hwidth
width of the embedded visualization in the HTML-output
在HTML输出宽度的嵌入式的可视化
参数：hheight
height of the embedded visualization in the HTML-output
嵌入式的可视化在HTML输出高度
参数：vrml_navigation
type of mouse navigation in the VRML file, can be "EXAMINE", "WALK", "SLIDE", "FLY" or "PAN" (VRML only)
在VRML文件类型的鼠标导航，可以“检查”，“WALK”，“滑动”，“FLY”或“PAN”（VRML只）
参数：vrml_transparency
a number between 0 and 1 specifying the transparency level of plotted objects (VRML only)
0和1之间的一个数，指定绘制对象的透明度级别（VRML只）
参数：vrml_fov
a scalar defining the field of view angle in the VRML file in radians (VRML only)
在VRML文件以弧度为单位定义的视野角（VRML只）的一个标量
参数：vrml_pos
a vector of size 3 corresponding to the position of the viewpoint (VRML only)
的大小为3的矢量对应的视点位置（VRML的只）
参数：vrml_dir
a vector of size 4 specifying the viewing direction (first 3 components) and the rotation of the camera around the direction vector (last component in radians, VRML only)
大小为4的矢量指定的观看方向（第3成分）和周围的摄像头的旋转的方向矢量（以弧度为单位的最后一个组件，VRML只）
参数：lg3d_ambientlight
ambient light gray level (value between 0 and 1, LG3D only)
环境光的灰度级（0和1之间的值，只LG3D）
Details
详细信息----------Details----------
mesh3d visualizes 3D-curves and surfaces specified as parametric functions as well 3D-meshes defined by vertex-coordinates and edges between them. The output can be generated in the VRML- or Livegraphics3D-format, or in the obj-format, if the x,y,z- and edges-parameters are specified. There are three ways to provide 3D data as input: An obj-file in the current directory can be used as by setting the obj\_infile-parameter, a 3D mesh can be specified using the x,y,z and edges parameter (in both cases, no other parameters are required), or a parametric function can be defined using the xfun, yfun and zfun parameters (in this case, param1, param2, range1 and range2 parameters have to be set additionally).
mesh3d可视化的三维曲线和曲面指定为参数功能以及3D网格所定义的顶点坐标和它们之间的边缘。可以产生输出在VRML的或Livegraphics3D的格式，或在obj格式，如果在x，y，z轴和边缘参数指定。提供三维的数据作为输入的方法有三种：一种obj的 - 在当前的目录中的文件可被用作通过设置的obj \ _infile参数，可以使用x，y，z和边缘参数（在指定的3D网格这两种情况下，需要没有其他参数），或一个参数的函数可以使用xfun定义，yfun和zfun参数（在这种情况下，参数1，param2的，范围1和范围2的参数都必须设置另外）。
To add additional shapes and objects to the final 3D scene, this plotting function can also be called within a VRML- or Livegraphics3D-environment created by calling the vrml.open() or lg3d.open() function. In this case, mesh3d will inherit all global parameters set in the vrml.open- or lg3d.open- function (e.g. filename, type, htmlout, etc.) and the user does not need to specify these options anymore.
要添加额外的形状和物体最终的3D场景，绘图功能也可以被称为内的VRML或Livegraphics3D的环境，通过调用的vrml.open（）或lg3d.open（）函数创建。在这种情况下，mesh3d将继承的vrml.open或lg3d.open功能（例如，文件名，类型，htmlout等）和用户设定的所有全局参数不需要再指定这些选项。
值----------Value----------
The function is used for its side-effect (creating a VRML-, Livegraphics3D-, or obj-file) and has no return value.
该功能用于其副作用（创建一个VRML，Livegraphics3D，或者obj文件），并没有返回值。
（作者）----------Author(s)----------
Enrico Glaab
参考文献----------References----------
3D Data Visualization on the Web. Journal of Statistical Software, 36(8), p. 1-18. URL: http://www.jstatsoft.org/v36/i08/
参见----------See Also----------
cloud3d, bar3d
cloud3d，bar3d
实例----------Examples----------
curdir <- getwd()
outdir <- tempdir()
setwd(outdir)
# Visualization of a parametric function[参数函数的可视化]
# defining the surface of 3D spiral[限定的表面的三维螺旋]
mesh3d(xfun = "s * cos(s) * (4 + cos(t + s))",
yfun = "s * sin(s) * (4 + cos(t + s))",
zfun = "s * sin(t + s)", param1 = "s",
param2 = "t",range1 = c(0, 4 * pi),
range2 = c(0, 2 * pi), type = "vrml",
filename = "spiral.wrl",
htmlout = "spiral.html")
# show the output in a web-browser [在Web浏览器中显示的输出]
# (VRML-plugin must be installed!)[（VRML插件必须安装！）]
if(file.exists(paste("file://",file.path(outdir,
"spiral.html"), sep = "")))
{
browseURL(paste("file://",file.path(outdir,
"spiral.html"), sep = ""))
}
setwd(curdir)
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-10-1 16:36:11
