new_colorref

The new_colorref function is a non-class version of the CColorRef:new method which creates and returns a new CColorRef object. The CColorRef class includes 3 properties for R, G, and B color intensities.

Syntax

C = new_colorref()

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

C = new_colorref( 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 = new_colorref( 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 = new_colorref( 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, new, delete


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