APIDo_SaveID

현재 창의 내용을 서로 다른 파일 포맷들로 저장합니다.

    GSErrCode ACAPI_Automate (
        APIDo_SaveID,
        API_FileSavePars*     fileSavePars,
        API_SavePars_...*     formatPars
    );

 

파라미터

fileSavePars

[in] 저장된 파일의 파라미터들입니다; 선택사항이며 만약 전달되지 않으면 기본 설정값들이 사용될 것입니다.

formatPars

[in] 요청된 포맷의 파라미터들입니다. API_SavePars_Archive, API_SavePars_Ifc, API_SavePars_Plandump, API_SavePars_Object, API_SavePars_Picture 또는 API_SavePars_Pdf 레코드 중 하나가 될 수 있습니다.

리턴 값

NoError

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

APIERR_REFUSEDCMD

함수가 알림 레벨로부터 호출되었습니다. 또는 ArchiCAD 데모 버전을 실행 중입니다.

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

설명

이 함수는 현재 창의 내용을 서로 다른 파일 포맷들로 저장하는 데 사용합니다.

이것은 알림 레벨로부터 호출될 수 없습니다; 만약 다른 애드온들이 실행 중이면 이 커맨드는 거부됩니다. 이 함수를 호출하면 이벤트 상의 다른 애드온들이 알림을 받을 수도 있습니다. 호출자 애드온은 아무런 알림을 받지 않습니다. 더 자세한 것은 알림 관리자를 보십시오.  

이것은 ArchiCAD의 데모 버전에서도 호출될 수 없습니다. 왜냐하면 API가 호스트 시스템의 행동을 흉내내려고 하기 때문입니다.

 

예제

API_FileSavePars        fsp;
API_SavePars_Picture    pars_pict;
GSErrCode               err;

BNZeroMemory (&fsp, sizeof (API_FileSavePars));
fsp.fileTypeID = APIFType_TIFFFile;

IO::Location folderLoc;
API_SpecFolderID specID = API_UserDocumentsFolderID;
ACAPI_Environment (APIEnv_GetSpecFolderID, &specID, &folderLoc);
fsp.file = new IO::Location (folderLoc, "PictTest.tif");

BNZeroMemory (&pars_pict, sizeof (API_SavePars_Picture));
pars_pict.colorDepth = APIColorDepth_256C;
pars_pict.dithered   = false;
pars_pict.view2D     = true;
pars_pict.crop       = true;

err = ACAPI_Automate (APIDo_SaveID, &fsp, &pars_pict);
if (err != NoError) {
    char msgStr[256];
    sprintf (msgStr, "Error in APIDo_SaveID (pict): %d", err);
    ACAPI_WriteReport (msgStr, true);
}

delete fsp.file;

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Automate.h

참고사항

API_FileSavePars, API_SavePars_Archive, API_SavePars_Ifc, API_SavePars_Plandump, API_SavePars_Object, API_SavePars_Picture, API_SavePars_Pdf,
ACAPI_Automate, API 함수