CColorRef:new

The new method creates an instance of the CColorRef class. You must call new before using any class methods or properties. Note that this object can also be created using the new_colorref function. The CColorRef class includes 3 properties for R, G, and B color intensities.

Syntax

C = CColorRef:new()

bullet.gif    Creates a new object with color initialized to (0,0,0).

C = CColorRef:new( CColorRef_old )

bullet.gif    This is a copy constructor. It creates a new CColorRef C initialized to the color of the CColorRef_old argument.

C = CColorRef:new( R, G, B )

bullet.gif    Creates a new CColorRef with members initialized to the R, G, and B values.

Remarks

Three overloads are provided for this method. They create a default CColorRef, a copy of a CColorRef, or an initialized CColorRef. If you pass something other than nil, a CColorRef, or data member values—such as a string—the default constructor is used.

Example

The following script computes the equivalent gray intensity using 2 different constructors:

A = CColorRef(255,140,5)

-- create CColorRef A with values

B = CColorRef:new( A )

-- copy A to a new CColorRef B

n = A:ToGray(B)

-- complement the color

Printf("%d,%d,%d -> %.2lf", A.R,A.G,A.B,n)

-- result: 255,140,5 -> 158.19

Printf("%d,%d,%d -> %.2lf", B.R,B.G,B.B,n)

-- result: 255,140,5 -> 158.19

Related Topics

CColorRef, delete, new_colorref


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.