CGUIViewImage 매뉴얼 - Image 관련 기능
개요
CGUIViewImage는 이미지 뷰를 나타내는 클래스입니다. 이 클래스는 CGUIViewImageBase 클래스를 상속받아 구현됩니다. 이 문서는 이미지 뷰어에서 이미지 로드, 저장, 닫기, 복사 및 붙여 넣기 기능을 설명합니다.
이미지 로드하기
Raw 이미지 로드
.raw 포맷의 이미지를 뷰에 불러오는 기능입니다.
LoadRaw 함수
.raw 포맷의 이미지를 뷰에 불러오는 함수입니다.
매개변수
- pWcsPath: 불러올 파일 경로 또는 폴더 경로입니다.
- i64Width: Raw 파일 이미지의 너비입니다. 음수로 설정하면 Raw 파일 너비 입력 다이얼로그가 활성화됩니다.
- i64Height: Raw 파일 이미지의 높이입니다. 0을 입력할 경우 자동으로 설정됩니다. 멀티페이지 raw 파일인 경우 정확한 높이 값을 입력해야 합니다.
- ePixelFormat: 이미지 포맷입니다.
- i32AlignByte: 얼라인 바이트입니다.
- i64OffsetByteFromBegin: 데이터의 시작 위치에 대한 오프셋입니다. 양수만 입력 가능합니다.
- i64OffsetByteFromEnd: 데이터의 끝 위치에 대한 파일 끝을 기점으로 한 오프셋입니다. 양수만 입력 가능합니다.
- eOption: 로드 옵션입니다 (LoadFile, AppendFile, InsertFile, DropFile 등).
반환값
- FLImaging::CResult: 함수 수행 결과를 반환합니다.
참조
- FLImaging::Base::EPixelFormat
- FLImaging::GUI::EViewImageLoadOption
- FLImaging::CResult
LoadRaw (파일 목록) 함수
개요
목록에 포함된 .raw 포맷의 이미지 파일을 뷰에 불러오는 함수입니다.
매개변수
- flaFilePathToLoad: 로드할 이미지 파일 목록입니다.
- eOption: 로드 옵션입니다 (LoadFile, LoadFolder, AppendFile, AppendFolder, InsertFile, InsertFolder, DropFile 등).
EViewImageLoadOption_OpenDialog는 사용 불가능합니다.
반환값
- FLImaging::CResult: 함수 수행 결과를 반환합니다.
참조
- FLImaging::Base::CFLArray
- FLImaging::Base::CFLString
- FLImaging::GUI::EViewImageLoadOption
- FLImaging::CResult
Save 함수
개요
이미지를 저장하는 함수입니다.
매개변수
- pWcsFileNameWithPath: 저장할 파일 경로입니다.
- bSaveCurrentPage: 멀티페이지 이미지의 경우 현재 페이지만 저장할지 여부를 지정합니다.
true일 경우 현재 페이지의 이미지만 저장하고,false일 경우 전체 페이지를 .FLIF 포맷으로 저장합니다. 기본값은false입니다. - bWithLayers: 레이어 포함 여부를 지정합니다.
반환값
- FLImaging::CResult: 함수 수행 결과를 반환합니다.
참조
- FLImaging::CResult
SavePage 함수
개요
이미지에서 선택한 페이지를 저장하는 함수입니다.
매개변수
- i32PageIndex: 저장할 페이지 인덱스입니다.
- pWcsFileNameWithPath: 저장할 파일 경로입니다.
반환값
- FLImaging::CResult: 함수 수행 결과를 반환합니다.
참조
- FLImaging::CResult
SavePages 함수
개요
이미지에서 선택한 여러 페이지들을 저장하는 함수입니다.
매개변수
- pFlaPageIndices: 저장할 페이지 인덱스 배열입니다 (예: 2, 5, 6, 7).
- pWcsFileNameWithPath: 저장할 파일 경로입니다.
반환값
- FLImaging::CResult: 함수 수행 결과를 반환합니다.
참조
- FLImaging::Base::CFLArray
- FLImaging::CResult
SavePages 함수
이미지에서 선택한 페이지들을 저장하는 함수입니다.
매개변수
pFlaPageIndices(저장할 페이지 인덱스 배열): 저장할 페이지의 인덱스 배열입니다. 예를 들어,[2, 5, 6, 7]과 같이 입력합니다.pWcsFileNameWithPath(저장할 파일 경로): 파일을 저장할 경로를 입력합니다.
반환값
const FLImaging::CResult: 함수 실행 결과를 반환합니다.
참고
FLImaging::Base::CFLArrayFLImaging::CResult
LoadFigure 함수
.fig 확장자를 가진 파일을 뷰에 불러오는 함수입니다.
매개변수
pWcsPath(불러올 파일 경로 또는 폴더 경로): 불러올 파일 또는 폴더의 경로를 입력합니다. 기본값은nullptr이며,nullptr인 경우 파일 열기 다이얼로그가 나타납니다. 경로가 주어진 경우, 파일 열기 다이얼로그 없이 해당 경로의 파일을 불러옵니다.bErrorMsgBox(로드 실패 시 메시지박스 여부): 로드에 실패했을 때 메시지 박스를 띄울지 여부를 설정합니다.
반환값
const FLImaging::CResult: 함수 실행 결과를 반환합니다.
참고
FLImaging::CResult
LoadFigureGBR 함수
.gbr 확장자를 가진 파일을 뷰에 불러오는 함수입니다.
매개변수
pWcsPath(불러올 파일 경로 또는 폴더 경로): 불러올 파일 또는 폴더의 경로를 입력합니다. 기본값은nullptr이며,nullptr인 경우 파일 열기 다이얼로그가 나타납니다. 경로가 주어진 경우, 파일 열기 다이얼로그 없이 해당 경로의 파일을 불러옵니다.i32LayerNo(레이어 인덱스):gbr데이터를 그릴 레이어의 인덱스를 입력합니다.-1일 경우 레이어 인덱스 선택 다이얼로그가 나타납니다. 최댓값은FLImaging::GUI::CGUIViewImage::EMaxLayerCount - 1입니다.bClearLayer(레이어 클리어 여부):GBR파일을 그리기 전에 모든 레이어를 클리어할지 여부를 설정합니다.
반환값
const FLImaging::CResult: 함수 실행 결과를 반환합니다.
참고
FLImaging::CResultFLImaging::GUI::CGUIViewImage::EMaxLayerCount
LoadFigureDXF 함수
.dxf 확장자를 가진 파일을 뷰에 불러오는 함수입니다.
매개변수
pWcsPath(불러올 파일 경로 또는 폴더 경로): 불러올 파일 또는 폴더의 경로를 입력합니다. 기본값은nullptr이며,nullptr인 경우 파일 열기 다이얼로그가 나타납니다. 경로가 주어진 경우, 파일 열기 다이얼로그 없이 해당 경로의 파일을 불러옵니다.bErrorMsgBox(로드 실패 시 메시지박스 여부): 로드에 실패했을 때 메시지 박스를 띄울지 여부를 설정합니다.
반환값
const FLImaging::CResult: 함수 실행 결과를 반환합니다.
참고
FLImaging::CResult
SaveFigure 함수
CFLFigure 객체를 .fig 확장자를 가진 파일로 저장하는 함수입니다.
매개변수
pFlFigure(저장할 Figure 객체): 저장할 Figure 객체의 포인터입니다.pWcsPath(저장할 파일 경로): 파일을 저장할 경로를 입력합니다.
반환값
const FLImaging::CResult: 함수 실행 결과를 반환합니다.
참고
FLImaging::CResult
이미지 처리 매뉴얼 (GUI 인터페이스)
1 파일 닫기
함수
ClearFile()
설명
GUI 인터페이스 상에서 이미지 파일을 닫습니다.
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
이미지 페이지 클리어
함수
ClearPage()
설명
GUI 인터페이스 상에서 현재 뷰에 띄워진 이미지의 페이지를 클리어합니다.
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
3 선택한 페이지 클리어
함수
ClearPages(Base::CFLArray<int32_t>* pFlaPageIndices)
설명
이미지에서 선택한 페이지들을 클리어합니다.
매개변수
pFlaPageIndices- 제거할 페이지 인덱스 배열 (예: 2, 5, 6, 7)
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
새 페이지 생성
함수
CreatePage(EViewImageCreatePageOption eOption = EViewImageCreatePageOption_Append)
설명
현재 뷰에 띄워진 이미지에 새 페이지를 생성합니다. eOption에 따라 이미지의 맨 뒤 또는 현재 페이지 위치에 새 페이지를 생성합니다.
매개변수
eOption-EViewImageCreatePageOption_Append이면 이미지의 맨 뒤에,EViewImageCreatePageOption_Insert이면 현재 페이지 위치에 새 페이지를 생성합니다.
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
새 이미지 생성
함수
CreateImage(int64_t i64Width, int64_t i64Height, int32_t i32Channel, int32_t i32Depth, Base::EValueType eType, bool bOptSeparateChannel, Base::CMultiVar<T>& flmvFillVal, int32_t i32AlignByte)
설명
현재 뷰에 새 이미지를 생성합니다.
매개변수
i64Width- 생성할 이미지의 너비i64Height- 생성할 이미지의 높이i32Channel- 생성할 이미지의 채널i32Depth- 생성할 이미지의 깊이eType- 생성할 이미지의 타입bOptSeparateChannel- 채널을 분리할 경우true, 그렇지 않을 경우falseflmvFillVal- 생성할 이미지에 채울 픽셀 값i32AlignByte- 생성할 이미지의 정렬 바이트
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
이미지 버퍼 존재 여부 확인
함수
DoesFLImageBufferExist()
설명
이미지 뷰에 이미지 버퍼가 있는지 여부를 확인합니다.
반환값
bool - 이미지 버퍼가 있는 경우 true, 그렇지 않은 경우 false를 반환합니다.
이미지 존재 여부 확인
함수
DoesFLImageExist()
설명
이미지 뷰에 이미지가 있는지 여부를 확인합니다.
반환값
bool - 이미지가 있는 경우 true, 그렇지 않은 경우 false를 반환합니다.
내장 이미지 포인터 얻기
함수
GetIntrinsicImage()
설명
이미지 뷰에 내장된 이미지 포인터를 얻어옵니다.
반환값
const FLImaging::Base::CFLImage* - 이미지 포인터를 반환합니다.
이미지 포인터 얻기
함수
GetImagePtr()
설명
이미지 뷰에 띄워진 이미지 포인터를 얻어옵니다.
반환값
const FLImaging::Base::CFLImage* - 이미지 포인터를 반환합니다.
이미지 포인터 설정
함수
SetImagePtr(Base::CFLImage* pFliImage)
설명
이미지 뷰에 띄울 이미지 포인터를 설정합니다.
매개변수
pFliImage- 설정할 이미지 포인터
반환값
const FLImaging::CResult - 수행 결과를 반환합니다.
이전 페이지로 이동 (MoveToPrevPage)
이미지 뷰에 표시된 이미지가 다중 페이지 이미지인 경우, 이전 페이지로 이동합니다.
- 반환값:
const FLImaging::CResult
이전 페이지로 이동한 결과를 반환합니다.
다음 페이지로 이동 (MoveToNextPage)
이미지 뷰에 표시된 이미지가 다중 페이지 이미지인 경우, 다음 페이지로 이동합니다.
- 반환값:
const FLImaging::CResult
다음 페이지로 이동한 결과를 반환합니다.
지정한 페이지로 이동 (MoveToPage)
이미지 뷰에 표시된 이미지가 다중 페이지 이미지인 경우, 지정한 페이지로 이동합니다.
- 매개변수:
i32PageNum: 이동할 페이지 번호
- 반환값:
const FLImaging::CResult
지정한 페이지로 이동한 결과를 반환합니다.
이미지 표시 여부 설정 (ShowImage)
이미지의 표시(show) 또는 숨김(hide) 여부를 설정합니다.
- 매개변수:
bShow: 이미지를 표시할 경우true, 숨길 경우false
이미지 표시 여부 확인 (IsImageVisible)
이미지가 표시(show) 중인지 숨겨져 있는지 확인합니다.
- 반환값:
bool
이미지를 표시 중일 경우true, 숨겨져 있을 경우false반환합니다.
화면 캡처
- 함수:
const CResult CaptureScreen(Base::CFLImage& fliImage, bool bIncludeFrame = false) - 설명: 현재 화면을 캡처합니다.
- 매개변수:
fliImage: 캡처한 화면을 저장하는 FLImage 객체.bIncludeFrame: 프레임을 포함하여 캡처할지 여부 설정 (기본값:false).
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
이미지 복사
- 함수:
const CResult CopyImage() - 설명: 현재 이미지를 복사합니다.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
페이지 복사
- 함수:
const CResult CopyPages(FLImaging::Base::CFLArray<int32_t>* pFlaPageIndices) - 설명: 선택한 페이지들을 클립보드에 복사합니다.
- 매개변수:
pFlaPageIndices: 복사할 페이지 인덱스 배열 (예: 2, 5, 6, 7).
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
이미지 붙여넣기
- 함수:
const CResult PasteImage() - 설명: 다른 뷰에서 복사한 이미지 또는 클립보드에 복사된 이미지를 현재 뷰에 붙여 넣습니다.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
특정 페이지에 이미지 붙여넣기
- 함수:
const CResult PasteImageAt(int32_t i32PageIndex) - 설명: 지정된 페이지 인덱스에 이미지를 삽입합니다.
- 매개변수:
i32PageIndex: 복사한 이미지를 삽입할 페이지 인덱스.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
이미지 회전
- 함수:
const CResult RotateImage(EImageRotateAngle eAngle) - 설명: 이미지를 90, 180, 270도로 회전합니다.
- 매개변수:
eAngle: 회전할 각도.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
이미지 뒤집기
- 함수:
const CResult FlipImage(EImageFlipDirection eDirection) - 설명: 이미지를 상하, 좌우, 상하좌우 방향으로 뒤집습니다.
- 매개변수:
eDirection: 뒤집을 방향.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)
페이지 순서 변경
- 함수:
const CResult RearrangePageOrder(int32_t i32OrigPageIndex, int32_t i32TargetPageIndex) - 설명: 페이지 순서를 변경합니다.
- 매개변수:
i32OrigPageIndex: 원본 페이지 인덱스.i32TargetPageIndex: 대상 페이지 인덱스, -1일 경우 마지막 페이지로 이동.
- 반환값: 수행 결과를 반환합니다. (
FLImaging::CResult)