R语言:convertColor()函数中文帮助文档(中英文对照)

loveR

convertColor(grDevices)
convertColor()所属R语言包：grDevices

                                        Convert between Colour Spaces
                                         彩色空间之间的转换

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Convert colours between their representations in standard colour spaces.
他们的意见在标准色彩空间之间转换颜色。


用法----------Usage----------


convertColor(color, from, to, from.ref.white, to.ref.white,
             scale.in=1, scale.out=1, clip=TRUE)



参数----------Arguments----------

参数：color
A matrix whose rows specify colors.  
A矩阵的行指定颜色。


参数：from,to
Input and output color spaces.  See "Details" below.
输入和输出的色彩空间。请参阅下面的“详细资料”。


参数：from.ref.white,to.ref.white
Reference whites or NULL if these are built in to the definition, as for RGB spaces. D65 is the default, see "Details" for others.  
参考白人或NULL如果这些都建立在定义为RGB空间。 D65是默认的，看到别人的“详细信息”。


参数：scale.in, scale.out
Input is divided by scale.in, output is multiplied by scale.out. Use NULL to suppress scaling when input or output is not numeric.
是由scale.in分为输入，输出乘以scale.out。使用NULL抑制结垢，当输入或输出是没有数字。


参数：clip
If TRUE, truncate RGB output to [0,1], FALSE return out-of-range RGB, NA set out of range colors to NaN.
如果TRUE，截断RGB输出到[0,1]，FALSE返回了范围的RGB，NA载范围的颜色NaN。


Details

详情----------Details----------

Color spaces are specified by objects of class colorConverter, created by colorConverter or make.rgb. Built-in color spaces may be referenced by strings: "XYZ", "sRGB", "Apple RGB", "CIE RGB", "Lab", "Luv". The converters for these colour spaces are in the object colorspaces.
指定对象类colorConvertercolorConverter或make.rgb创造，色彩空间。内置的色彩空间，可以由字符串引用："XYZ"，"sRGB"，"Apple RGB"，"CIE RGB"，"Lab"，"Luv"。这些色彩空间转换器中的对象colorspaces。

The "sRGB" color space is that used by standard PC monitors. "Apple RGB" is used by Apple monitors. "Lab" and "Luv" are approximately perceptually uniform spaces standardized by the Commission Internationale d'Eclairage. XYZ is a 1931 CIE standard capable of representing all visible colors (and then some), but not in a perceptually uniform way.
"sRGB"色彩空间的是，使用标准的PC显示器。 "Apple RGB"使用苹果显示器。 "Lab"和"Luv"约感知均匀空间由委员会国际歌DEclairage标准化。 XYZ是1931年CIE标准能够代表所有可见颜色（然后部分），但不是在一个感性的统一方式。

The Lab and Luv spaces describe colors of objects, and so require the specification of a reference "white light" color.  Illuminant D65 is a standard indirect daylight, Illuminant D50 is close to direct sunlight, and Illuminant A is the light from a standard incandescent bulb. Other standard CIE illuminants supported are B, C, E and D55.  RGB colour spaces are defined relative to a particular reference white, and can be only approximately translated to other reference whites.  The Bradford chromatic adaptation algorithm is used for this.
Lab和Luv空间描述物体的颜色，所以需要参考白光的颜色规范。光源D65是一个标准的间接日光，光源D50靠近阳光直射，和光源A的是从一个标准的白炽灯泡的光。其他支持CIE的标准照明B，C，E和D55。 RGB色彩空间是指相对于一个特定的参考白，可以转换到其他参考白人只有约。布拉德福德色适应算法用于此。

The RGB color spaces are specific to a particular class of display. An RGB space cannot represent all colors, and the clip option controls what is done to out-of-range colors.
具体到某一类的显示的RGB色彩空间。一个RGB空间不能代表所有的颜色，clip选项控制范围的颜色做了什么。


值----------Value----------

A 3-row matrix whose columns specify the colors.
一个3列的矩阵，其列指定的颜色。


参考文献----------References----------


http://www.efg2.com/Lab/Graphics/Colors/Chromaticity.htm.

参见----------See Also----------

col2rgb and colors for ways to specify colors in graphics.
col2rgb和colors的方式来指定颜色的图形。

make.rgb for specifying other colour spaces.
make.rgb指定其他的色彩空间。


举例----------Examples----------


require(graphics); require(stats) # for na.omit[为na.omit]
par(mfrow=c(2,2))
## The displayable colors from four planes of Lab space[＃从四个实验室空间平面显示颜色]
ab <- expand.grid(a=(-10:15)*10,b=(-15:10)*10)

Lab <- cbind(L=20,ab)
srgb <- convertColor(Lab,from="Lab",to="sRGB",clip=NA)
clipped <- attr(na.omit(srgb),"na.action")
srgb[clipped,] <- 0
cols <- rgb(srgb[,1],srgb[,2],srgb[,3])
image((-10:15)*10,(-15:10)*10,matrix(126*26),ncol=26),col=cols,
  xlab="a",ylab="b",main="Lab: L=20")

Lab <- cbind(L=40,ab)
srgb <- convertColor(Lab,from="Lab",to="sRGB",clip=NA)
clipped <- attr(na.omit(srgb),"na.action")
srgb[clipped,] <- 0
cols <- rgb(srgb[,1],srgb[,2],srgb[,3])
image((-10:15)*10,(-15:10)*10,matrix(126*26),ncol=26),col=cols,
  xlab="a",ylab="b",main="Lab: L=40")

Lab <- cbind(L=60,ab)
srgb <- convertColor(Lab,from="Lab",to="sRGB",clip=NA)
clipped <- attr(na.omit(srgb),"na.action")
srgb[clipped,] <- 0
cols <- rgb(srgb[,1],srgb[,2],srgb[,3])
image((-10:15)*10,(-15:10)*10,matrix(126*26),ncol=26),col=cols,
  xlab="a",ylab="b",main="Lab: L=60")

Lab <- cbind(L=80,ab)
srgb <- convertColor(Lab,from="Lab",to="sRGB",clip=NA)
clipped <- attr(na.omit(srgb),"na.action")
srgb[clipped,] <- 0
cols <- rgb(srgb[,1],srgb[,2],srgb[,3])
image((-10:15)*10,(-15:10)*10,matrix(126*26),ncol=26),col=cols,
  xlab="a",ylab="b",main="Lab: L=80")

(cols <- t(col2rgb(palette())))
zapsmall(lab <- convertColor(cols,from="sRGB",to="Lab",scale.in=255))
round(convertColor(lab,from="Lab",to="sRGB",scale.out=255))

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。