속성 정보 검색

모듈 설명

이 섹션에서는 최소 및 최대값, 모드 유형, 현재 모드, 이름 등과 같은 캐릭터 속성에 대한 정보를 검색하기 위한 함수를 설명합니다.

일반적으로 이러한 함수는 캐릭터 속성을 제어하기 위한 그래픽 사용자 인터페이스를 작성하는 경우 유용합니다.

속성 모드, 모드 유형 및 값에 대한 자세한 내용은 캐릭터 속성을 참조하십시오.

열거
enum	HIKPropertyModeType { HIKPropertyNoMode = 0, HIKPropertyOffOn, HIKPropertyOffAutoUser, HIKPropertyAutoUser }
	캐릭터 속성에 대한 가능한 모드 유형을 나열합니다. HIKGetPropertyInfoModeType()을 참조하십시오. 자세한 내용...
enum	HIKPropertyUnit {   HIKPropertyNoUnit = 0, HIKPropertyPercent, HIKPropertySecond, HIKPropertyCentimeter,   HIKPropertyDegree, HIKPropertyEnum, HIKPropertyReal }
	캐릭터 속성에 대한 가능한 단위 유형을 나열합니다. HIKGetPropertyInfoUnit()을 참조하십시오. 자세한 내용...
enum	HIKPropertyValueType { HIKPropertyScalar = 0 }
	캐릭터 속성에 대한 가능한 값 유형을 나열합니다. HIKGetPropertyInfoValueType()을 참조하십시오. 자세한 내용...

함수
const char *	HIKGetPropertyEnumName (int pPropertyId, int pValue)
	속성 pValue에 대한 열거 값 pPropertyId를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다. 자세한 내용...
int	HIKGetPropertyId (const char *pName)
	설명을 포함하는 해당 이름에서 속성 pName의 고유 ID를 검색합니다. 자세한 내용...
float	HIKGetPropertyInfoDefaultMax (int pPropertyId)
	속성 pPropertyId에 대한 최대 허용 값을 검색합니다. 자세한 내용...
float	HIKGetPropertyInfoDefaultMin (int pPropertyId)
	속성 pPropertyId에 대한 최소 허용 값을 검색합니다. 자세한 내용...
int	HIKGetPropertyInfoDefaultMode (int pPropertyId)
	속성 pPropertyId에 대한 기본 모드를 검색합니다. 자세한 내용...
float	HIKGetPropertyInfoDefaultValue (int pPropertyId)
	속성 pPropertyId에 대한 기본값을 검색합니다. 자세한 내용...
eHIKPropertyModeType	HIKGetPropertyInfoModeType (int pPropertyId)
	속성 pPropertyId에 대한 모드 유형을 검색합니다. 자세한 내용...
eHIKPropertyUnit	HIKGetPropertyInfoUnit (int pPropertyId)
	속성 pPropertyId에 대한 단위 유형을 검색합니다. 자세한 내용...
eHIKPropertyValueType	HIKGetPropertyInfoValueType (int pPropertyId)
	속성 pPropertyId에 대한 값 유형을 검색합니다. 자세한 내용...
const char *	HIKGetPropertyModeName (int pPropertyId, int pMode)
	속성 pMode에 대한 모드 pPropertyId를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다. 자세한 내용...
const char *	HIKGetPropertyName (int pPropertyId)
	속성 pPropertyId를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다. 자세한 내용...
int	HIKIsPropertyDescription (int pPropertyId)
	속성이 설명인지 여부를 나타냅니다. 자세한 내용...

열거 유형 설명서

enum HIKPropertyModeType

캐릭터 속성에 대한 가능한 모드 유형을 나열합니다. HIKGetPropertyInfoModeType()을 참조하십시오.

가능한 모드는 다음과 같습니다.

• Off: 속성이 해제됩니다.
• On: 속성이 설정됩니다.
• Auto: 속성 값이 HumanIK에 의해 제어됩니다.
• User: 속성 값이 사용자에 의해 제어됩니다.

비고

"Off(0), On(1)"과 같이 열거 설명의 각 모드에 대해 나열된 값은, 모드가 설정된 경우 HIKSetPropertyMode()의 pMode 매개변수에 전달되어야 하는 값입니다. HIKSetPropertyMode() 및 HIKGetPropertyMode()를 참조하십시오.

열거자
HIKPropertyNoMode	이 모드 유형을 사용하는 속성이 항상 설정된 경우 그 현재 값이 HumanIK 솔버에서 항상 고려됩니다.
HIKPropertyOffOn	이 모드 유형을 사용하는 속성은 Off(0) 또는 On(1) 모드로 설정될 수 있습니다.
HIKPropertyOffAutoUser	이 모드 유형을 사용하는 속성은 Off(0), Auto(1) 또는 User(2) 모드로 설정될 수 있습니다.
HIKPropertyAutoUser	이 모드 유형을 사용하는 속성은 Auto(0) 또는 User(1) 모드로 설정될 수 있지만 비활성화될 수는 없습니다.

enum HIKPropertyUnit

캐릭터 속성에 대한 가능한 단위 유형을 나열합니다. HIKGetPropertyInfoUnit()을 참조하십시오.

열거자
HIKPropertyNoUnit	이 속성의 값을 절대 사용해서는 안 된다는 것을 나타냅니다. 일반적으로 모드 유형 HIKPropertyOffOn을 사용하는 속성에 대해서만 사용되어 속성이 단순한 설정/해제 토글임을 나타냅니다.
HIKPropertyPercent	속성 값이 0.0과 1.0 사이의 범위로 표현됩니다.
HIKPropertySecond	속성 값이 초 단위로 저장됩니다.
HIKPropertyCentimeter	속성 값이 스칼라 거리입니다. 측정 단위는 HIKCharacter의 형상을 캐릭터화하는 경우에 사용되는 단위와 동일해야 합니다. 이 값 유형을 사용하는 모든 속성의 기본값 크기는 대략 키가 180 단위인 캐릭터에 맞게 지정되기 때문에 이 단위는 "센티미터"로만 지칭합니다.
HIKPropertyDegree	속성 값이 도 단위로 저장됩니다.
HIKPropertyEnum	속성 값이 정수이며 그 해석은 해당 속성에 고유한 열거에 의해 정의됩니다. 자세한 내용은 각 속성 설명을 참조하십시오. HIKSetPropertyMode() 및 HIKGetPropertyMode() 함수를 사용하여 이러한 속성에 대한 열거 값을 설정하고 가져옵니다.
HIKPropertyReal	속성 값이 임의 부동 소수점 숫자입니다.

enum HIKPropertyValueType

캐릭터 속성에 대한 가능한 값 유형을 나열합니다. HIKGetPropertyInfoValueType()을 참조하십시오.

열거자
HIKPropertyScalar	속성이 스칼라입니다.

함수 설명서

const char* HIKGetPropertyEnumName	(	int	pPropertyId,
		int	pValue
	)

속성 pPropertyId에 대한 열거 값 pValue를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다.

매개변수

pPropertyId	속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오. 이 속성에는 단위 유형 HIKPropertyEnum이 있어야 합니다.
pValue	이름을 검색할 열거 값을 나타내는 정수

반환

열거 값을 식별하는 문자열

int HIKGetPropertyId

(

const char *

pName

)

설명을 포함하는 해당 이름에서 속성 pName의 고유 ID를 검색합니다.

매개변수

pName

속성의 고유 이름. 속성에 대한 HIKGetPropertyName()에서 반환되는 문자열과 일치해야 합니다.

반환

속성 ID. 가능한 값은 HIKProperty 열거를 참조하십시오. -1은 일치하는 속성을 발견할 수 없음을 나타냅니다.

float HIKGetPropertyInfoDefaultMax

(

int

pPropertyId

)

속성 pPropertyId에 대한 최대 허용 값을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 최대값

float HIKGetPropertyInfoDefaultMin

(

int

pPropertyId

)

속성 pPropertyId에 대한 최소 허용 값을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 최소값

int HIKGetPropertyInfoDefaultMode

(

int

pPropertyId

)

속성 pPropertyId에 대한 기본 모드를 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성에 대한 기본 모드를 나타내는 정수. 이 정수의 해석은 속성의 모드 유형에 따라 다릅니다. HIKPropertyModeType 열거를 참조하십시오.

float HIKGetPropertyInfoDefaultValue

(

int

pPropertyId

)

속성 pPropertyId에 대한 기본값을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 기본값

eHIKPropertyModeType HIKGetPropertyInfoModeType

(

int

pPropertyId

)

속성 pPropertyId에 대한 모드 유형을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 가능한 모드 유형을 나타내는 열거 값. 가능한 값은 HIKPropertyModeType 열거를 참조하십시오.

eHIKPropertyUnit HIKGetPropertyInfoUnit

(

int

pPropertyId

)

속성 pPropertyId에 대한 단위 유형을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 단위 유형을 나타내는 열거 값. 가능한 값은 HIKPropertyUnit 열거를 참조하십시오.

eHIKPropertyValueType HIKGetPropertyInfoValueType

(

int

pPropertyId

)

속성 pPropertyId에 대한 값 유형을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성의 값 유형을 나타내는 열거 값. 가능한 값은 HIKPropertyValueType 열거를 참조하십시오.

const char* HIKGetPropertyModeName	(	int	pPropertyId,
		int	pMode
	)

속성 pPropertyId에 대한 모드 pMode를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다.

매개변수

pPropertyId	속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.
pMode	이름을 검색할 모드를 나타내는 정수. 이 정수의 해석은 속성의 모드 유형에 따라 다릅니다. HIKPropertyModeType 열거를 참조하십시오.

반환

속성의 현재 모드를 나타내는 문자열

const char* HIKGetPropertyName

(

int

pPropertyId

)

속성 pPropertyId를 식별하는 영어로 된 읽을 수 있는 문자열을 검색합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성 이름

int HIKIsPropertyDescription

(

int

pPropertyId

)

속성이 설명인지 여부를 나타냅니다.

캐릭터의 자세 또는 차원을 정의하는 경우 속성이 일반적으로 "설명"으로 간주됩니다(예: 바닥 접점 엔진에 대한 캐릭터의 손과 발의 윤곽을 정의하는 데 사용되는 속성). 반대로 설명이 아닌 속성은 대부분의 다른 속성의 경우처럼 일반적으로 특정 방법을 통해 HumanIK 솔버를 제어하거나 제한합니다.

매개변수

pPropertyId

속성의 고유 ID. 가능한 값은 HIKProperty 열거를 참조하십시오.

반환

속성이 설명이면 1, 그렇지 않으면 0입니다.