APIEnv_ChangePlaceSetsID

장소 설정들을 변경합니다.

    GSErrCode ACAPI_Environment (
        APIEnv_ChangePlaceSetsID,
        API_PlaceInfo*     placeInfo
    );

 

파라미터

placeInfo

[in] 이 structure는 장소의 파라미터들을 저장합니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

placeInfo가 NULL이거나 유효하지 않은 데이터를 포함하고 있습니다.

APIERR_NOPLAN

열린 프로젝트가 없습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 도면의 현재 city, 날짜, 시간, 북쪽 방향 파라미터들을 세트/변경하는 데 사용합니다. 태양 각도들은 주어진 city와 주어진 날짜와 시간을 기반으로 계산됩니다. 계산된 각도들은 API_PlaceInfo structure의 sunAngXY와 sunAngZ 필드들 안에 리턴됩니다.

커스텀 장소에서, 특정 날짜일 때의 태양 파라미터들을 계산하려면 APIEnv_GetPlaceSetsID 함수를 참조하십시오.

 

예제

API_PlaceInfo  placeInfo;
GSErrCode      err;

BNZeroMemory (&placeInfo, sizeof (API_PlaceInfo));
err = ACAPI_Environment (APIEnv_GetPlaceSetsID, &placeInfo, NULL);
placeInfo.north += PI/2;
err = ACAPI_Environment (APIEnv_ChangePlaceSetsID, &placeInfo, NULL);

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Environment.h

 

참고사항

API_PlaceInfo, APIEnv_CanChangePlaceSetsID
ACAPI_Environment, API 함수