Class AcCmColor

Constructs a new AcCmColor.

Gets the blue component (0–255).

Gets the AutoCAD Color Index (ACI), or undefined if not ByACI, ByBlock, or ByLayer.

Sets the AutoCAD Color Index (0–256).

• 0 sets the color method to ByBlock
• 256 sets the color method to ByLayer
• 1–255 sets the color method to ByACI

Gets the current color method.

Sets the color method.

Note: Changing the method does not modify _value.

Gets the color name.

For ByColor or ByACI, resolves the name via AcCmColorUtil. For ByLayer or ByBlock, returns the corresponding string.

Sets the color by name.

Resolves the name to an RGB value via AcCmColorUtil.

Gets the CSS RGB color string (e.g., "rgb(255,0,255)").

Gets the green component (0–255).

Gets the hexadecimal representation of the color (e.g., "0xFF00FF").

Returns true if the color method is ByACI.

Returns true if the color method is ByBlock.

Returns true if the color method is ByColor (explicit RGB).

Returns true if the color method is ByLayer.

Returns true if the color method is ByACI and ACI value is 7

Notes: In AutoCAD, ACI Color 7 (Color Index 7) is officially named "Black" or "White" depending on the context, but it is functionally defined as the "Contrasting Color" or "Auto-Contrast Color." Here is the technical explanation of its behavior:

• If the background is dark: Color 7 displays as White.
• If the background is light: Color 7 displays as Black.

Gets the red component (0–255).

Gets the packed RGB value (0xRRGGBB).

• For ByColor, returns _value directly
• For ByACI, converts index to RGB via AcCmColorUtil
• For ByLayer or ByBlock, returns _value directly

Creates a clone of this color instance.

Copies color values from another AcCmColor instance.

Returns a CSS rgba() color string with the specified alpha value.

Checks equality with another color.

Sets the color to ByBlock.

Sets the color to ByLayer.

Sets the color to ACI value 7.

Sets the RGB color.

Sets the RGB color from a CSS color string.

Examples:

• "#FF00FF"
• "#F0F"
• "rgb(255,0,255)"
• "rgba(255,0,255,0.5)"
• "red" (named colors)

Sets the RGB color by a single packed number (0xRRGGBB).

Sets the color as a scalar grayscale value.

Returns a string representation of the color.

• "ByLayer" for ByLayer colors
• "ByBlock" for ByBlock colors
• One number for color index
• Three comma-separated numbers for RGB color

Creates one AcCmColor from one string