---
title: "Интерфейс IColorParam7"
type: interface
api: [api7]
domain: [3d]
tags: [interface, api7, 3d, icolorparam7]
sources:
  - icolorparam7.html
---

*API интерфейсов. Версия 7 > Документ 3D  > Свойства цвета объекта *


## Интерфейс IColorParam7

Свойства цвета объекта.
Иерархия:
IDispatch
IColorParam7
Примечание:
1. Интерфейс является дополнительным для IModelObject, IBody7IEmbodiment.
2. Оптические свойства используются для верхнего компонента, вставки, тела, операций, поверхностей, грани. Для остальных объектов используется только цвет и свойство UseColor.
3. Оптические свойства задаются в относительных единицах 0...1.


## Ambient - Общий свет

Тип данных: double
Значения свойства:
| | - Общий свет (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
Ambient = Object.Ambient    Получить свойство (* )
Object.Ambient = Ambient    Установить свойство (* )
Ambient = Object.GetAmbient()    Получить свойство (**)
Object.SetAmbient (Ambient)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Ambient( &Ambient )    Получить свойство
Object.put_Ambient( Ambient )    Установить свойство
```


## Color - Цвет

Тип данных: long
Синтаксис Automation:
```
Color = Object.Color    Получить свойство (* )
Object.Color = Color    Установить свойство (* )
Color = Object.GetColor()    Получить свойство (**)
Object.SetColor( Color )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Color( &Color )    Получить свойство
Object.put_Color( Color )    Установить свойство
```


## Diffuse - Диффузия

Тип данных: double
Значения свойства:
| | - Диффузия (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
Diffuse = Object.diffuse    Получить свойство (* )
Object.diffuse = diffuse    Установить свойство (* )
Diffuse = Object.GetDiffuse()    Получить свойство (**)
Object.SetDiffuse (diffuse)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Diffuse( &Diffuse )    Получить свойство
Object.put_Diffuse( Diffuse )    Установить свойство
```


## Emission - Излучение

Тип данных: double
Значения свойства:
| | - Излучение (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
Emission = Object.Emission    Получить свойство (* )
Object.Emission = Emission    Установить свойство (* )
Emission = Object.GetEmission()    Получить свойство (**)
Object.SetEmission(Emission)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Emission( &Emission )    Получить свойство
Object.put_Emission( Emission )    Установить свойство
```


## GetAdvancedColor - Получить параметры цвета объекта

Синтаксис Automation:
```
BOOL GetAdvancedColor( long* Color,
double* Ambient,
double* Diffuse,
double* Specularity,
double* Shininess,
double* Transparency,
double* Emission );
```
Синтаксис COM:
```
HRESULT GetAdvancedColor( long* Color,
double* Ambient,
double* Diffuse,
double* Specularity,
double* Shininess,
double* Transparency,
double* Emission,
BOOL * Result );
Выходные параметры:
color    цвет,
ambient    Общий свет,
diffuse    Диффузия,
specularity    Зеркальность,
shininess    Блеск,
transparency    Прозрачность,
emission    Излучение.
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
```
Примечание:
Оптические свойства задаются в относительных единицах от 0..1.


## SetAdvancedColor - Установить параметры цвета объекта

Синтаксис Automation:
```
BOOL SetAdvancedColor( long* Color,
double* Ambient,
double* Diffuse,
double* Specularity,
double* Shininess,
double* Transparency,
double* Emission );
```
Синтаксис COM:
```
HRESULT SetAdvancedColor( long* Color,
double* Ambient,
double* Diffuse,
double* Specularity,
double* Shininess,
double* Transparency,
double* Emission,
BOOL * Result );
Выходные параметры:
color    цвет,
ambient    Общий свет,
diffuse    Диффузия,
specularity    Зеркальность,
shininess    Блеск,
transparency    Прозрачность,
emission    Излучение.
Возвращаемое значение:
TRUE    - в случае успешного завершения,
FALSE    - в случае неудачи.
```
Примечание:
Оптические свойства задаются в относительных единицах от 0..1.


## Shininess - Блеск

Тип данных: double
Значения свойства:
| | - Блеск (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
Shininess = Object.Shininess    Получить свойство (* )
Object.Shininess = Shininess    Установить свойство (* )
Shininess = Object.GetShininess()    Получить свойство (**)
Object.SetShininess (Shininess)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Shininess( &Shininess )    Получить свойство
Object.put_Shininess( Shininess )    Установить свойство
```


## Specularity - Зеркальность

Тип данных: double
Значения свойства:
| | - Зеркальность (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
specularity = Object.specularity    Получить свойство (* )
Object.specularity = specularity    Установить свойство (* )
specularity = Object.GetSpecularity()    Получить свойство (**)
Object.SetSpecularity (specularity)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Specularity( &Specularity )    Получить свойство
Object.put_Specularity( Specularity )    Установить свойство
```


## Transparency - Прозрачность

Тип данных: double
Значения свойства:
| | - Прозрачность (от 0 до 1). |
| --- | --- |
Синтаксис Automation:
```
Transparency = Object.Transparency    Получить свойство (* )
Object.Transparency = Transparency    Установить свойство (* )
Transparency = Object.GetTransparency()    Получить свойство (**)
Object.SetTransparency (Transparency)    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_Transparency( &Transparency )    Получить свойство
Object.get_Transparency( &Transparency )    Установить свойство
```
Примечание:
Этот параметр характеризует способность поверхности пропускать падающий на нее свет. Если значение этого параметра равно 1 (или 100%), то поверхность совершенно непрозрачная. При моделировании деталей из стекла, органического стекла, слюды, бесцветного полиэтилена и подобных материалов значение прозрачности выбирают из диапазона между 0 и 1.
Если значение этого параметра равно 0,5 (или 50%), то поверхность полупрозрачная.
Если значение этого параметра равно 0, то поверхность полностью прозрачная. Такая поверхность невидима.


## UseColor - Используемый цвет

Тип данных: из перечисления UseColor
Синтаксис Automation:
```
UseColor = Object.UseColor    Получить свойство (* )
Object.UseColor = UseColor    Установить свойство (* )
UseColor = Object.GetUseColor()    Получить свойство (**)
Object.SetUseColor( UseColor )    Установить свойство (**)
```
Синтаксис COM:
```
Object.get_UseColor( &UseColor )    Получить свойство
Object.put_UseColor( UseColor )    Установить свойство
Использование свойства для объектов:
Верхний компонент
useColorOur    0    собственный цвет
Вставка в сборку
useColorOur    0    собственный цвет
useColorOwner    1    цвет сборки
useColorSource    2    цвет источника
Грань, операции, объекты детали
useColorOur    0    собственный цвет
useColorSource    2    цвет источника
Операции: вырезать выдавливанием, скругление, фаска, отверстие, оболочка, сечение плоскостью, сечение эскизом, удалить грань
useColorOur    0    собственный цвет
useColorOwner    1    цвет сборки
useColorSource    2    цвет источника
Тело
useColorOur    0    собственный цвет
useColorSource    2    цвет источника
```
Примечание:
В случае ошибки возвращается useColorUnknown.
