APIEnv_ChangeRenderingSetsID

포토렌더링 설정들을 변경합니다.

    GSErrCode ACAPI_Environment (
        APIEnv_ChangeRenderingSetsID,
        API_RendEffects...*     rendEffects,
        API_RendSetTypeID       rendSetType
    );

 

파라미터

rendEffects

[in] "PhotoRendering Settings..." 탭 페이지의 데이터입니다. 타입은 prefsType 파라미터에 따라 달라집니다.

rendSetType

[in] 변경하고 싶은 PhotoRendering Settings의 타입입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

rendInfo가 NULL이거나 rendSetType이 유효하지 않습니다.

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

 

설명

이 함수는 "PhotoRendering Settings..." 다이얼로그의 서로 다른 탭 페이지들의 설정들을 변경하는 데 사용합니다.

사용할 수 있는 포토렌더링 타입(rendInfo)들의 structure들은 다음과 같습니다:

• API_RendEffects,
• API_RendImage,
• API_RendBrightness

참고: rendSetType은 포인터가 아니라 값으로서 전달되어야 합니다; 아래 예제를 보십시오.

  만약 API_RendImage 파라미터의 bkgPictFile 포인터 안에 유효한 위치를 전달하고, 참조된 파일이 현재 로드된 어떤 라이브러리에도 속하지 않으면, 이미지 파일은 프로젝트의 내장된 라이브러리로 복사될 것입니다. 또한 이것은 당신이 그것을 제거하기 전까지는 본래 이미지 파일에 대한 후속 수정들이 배경 그림 렌더링에 영향을 미치지 않게 되고, 그것을 또 라이브러리에 추가한다는 것을 의미합니다.

 

예제

API_RendEffects      rendEffects;
API_RendImage        rendImage;
API_RendBrightness   rendBright;
GSErrCode            err;

BNZeroMemory (&rendEffects, sizeof (API_RendEffects));
err = ACAPI_Environment (APIEnv_GetRenderingSetsID, &rendEffects, (void *) (Int32) APIRendSet_EffectsID);
if (err == NoError) {
    rendEffects.method = API_RendMethod_Best;
    rendEffects.decayOn = true;
    rendEffects.shadowOn = true;
    err = ACAPI_Environment (APIEnv_ChangeRenderingSetsID, &rendEffects, (void *) (Int32) APIRendSet_EffectsID);
}

BNZeroMemory (&rendImage, sizeof (API_RendImage));
err = ACAPI_Environment (APIEnv_GetRenderingSetsID, &rendImage, (void *) (Int32) APIRendSet_ImageID);
if (err == NoError) {
    rendImage.bkgSkyRGB.f_red   = 0.7;
    rendImage.bkgSkyRGB.f_green = 0.5;
    rendImage.bkgSkyRGB.f_blue  = 1.0;
    err = ACAPI_Environment (APIEnv_ChangeRenderingSetsID, &rendImage, (void *) (Int32) APIRendSet_ImageID);
}
delete rendImage.bkgPictFile;

BNZeroMemory (&rendBright, sizeof (API_RendBrightness));
err = ACAPI_Environment (APIEnv_GetRenderingSetsID, &rendBright, (void *) (Int32) APIRendSet_BrightnessID);
if (err == NoError) {
    rendBright.brightness = 25;
    rendBright.overExpoCorrMethod = API_RendCorr_PaintOverExpSurf;
    err = ACAPI_Environment (APIEnv_ChangeRenderingSetsID, &rendBright, (void *) (Int32) APIRendSet_BrightnessID);
}

 

요구사항

버전: API 3.1 또는 이후

헤더: APIdefs_Environment.h

 

참고사항

API_RendEffects, API_RendImage, API_RendBrightness, API_RendSetTypeID,
ACAPI_Environment, APIEnv_GetRenderingSetsID, APIEnv_GetRenderingSceneNamesID, APIEnv_SetCurrentRenderingSceneID, APIDo_PhotoRenderID, API 함수