Table of Contents

Class InputFrame

네임스페이스
easyar

입력 프레임. 이미지, camera 파라미터, 타임스탬프, 월드 좌표계에 대한 카메라의 변환(transform), 추적 상태를 포함합니다. 여기서 camera 파라미터, 타임스탬프, 월드 좌표계에 대한 카메라의 변환, 추적 상태는 모두 선택 사항이지만, 특정 알고리즘 구성 요소는 입력에 대한 특정 요구 사항을 가질 수 있습니다.

InputFrame

메서드

index

인덱스, 자체 증가하는 숫자, 각 입력 프레임마다 다름.

int easyar_InputFrame_index(const easyar_InputFrame * This)
int index()
public int index()
fun index(): Int
- (int)index
public func index() -> Int32
public virtual int index()

반환 값

형식 설명
Int32

image

이미지 가져오기

void easyar_InputFrame_image(const easyar_InputFrame * This, easyar_Image * * Return)
std::shared_ptr<Image> image()
public @Nonnull Image image()
fun image(): Image
- (easyar_Image *)image
public func image() -> Image
public virtual Image image()

반환 값

형식 설명
Image

hasCameraParameters

카메라 파라미터 포함 여부

bool easyar_InputFrame_hasCameraParameters(const easyar_InputFrame * This)
bool hasCameraParameters()
public boolean hasCameraParameters()
fun hasCameraParameters(): Boolean
- (bool)hasCameraParameters
public func hasCameraParameters() -> Bool
public virtual bool hasCameraParameters()

반환 값

형식 설명
Boolean

cameraParameters

카메라 파라미터 가져오기.

void easyar_InputFrame_cameraParameters(const easyar_InputFrame * This, easyar_CameraParameters * * Return)
std::shared_ptr<CameraParameters> cameraParameters()
public @Nonnull CameraParameters cameraParameters()
fun cameraParameters(): CameraParameters
- (easyar_CameraParameters *)cameraParameters
public func cameraParameters() -> CameraParameters
public virtual CameraParameters cameraParameters()

반환 값

형식 설명
CameraParameters

hasTemporalInformation

不包含时间信息(时间戳)。

bool easyar_InputFrame_hasTemporalInformation(const easyar_InputFrame * This)
bool hasTemporalInformation()
public boolean hasTemporalInformation()
fun hasTemporalInformation(): Boolean
- (bool)hasTemporalInformation
public func hasTemporalInformation() -> Bool
public virtual bool hasTemporalInformation()

반환 값

형식 설명
Boolean

timestamp

타임스탬프. 단위는 초.

double easyar_InputFrame_timestamp(const easyar_InputFrame * This)
double timestamp()
public double timestamp()
fun timestamp(): Double
- (double)timestamp
public func timestamp() -> Double
public virtual double timestamp()

반환 값

형식 설명
Double

hasSpatialInformation

공간 정보(cameraTransform 및 trackingStatus)를 포함하는지 여부.

bool easyar_InputFrame_hasSpatialInformation(const easyar_InputFrame * This)
bool hasSpatialInformation()
public boolean hasSpatialInformation()
fun hasSpatialInformation(): Boolean
- (bool)hasSpatialInformation
public func hasSpatialInformation() -> Bool
public virtual bool hasSpatialInformation()

반환 값

형식 설명
Boolean

cameraTransform

카메라가 월드 좌표계에 상대적인 변환. 이때 카메라 좌표계와 월드 좌표계 모두 오른손 좌표계이다. 카메라 좌표계의 원점은 카메라의 광학 중심이며, x축 양의 방향은 오른쪽, y축 양의 방향은 위쪽, z축 양의 방향은 빛이 카메라로 들어오는 방향이다. (여기서 오른쪽과 위쪽은 카메라 이미지에서의 오른쪽과 위쪽을 의미하며, 기기의 자연스러운 방향과 다를 수 있다.) 데이터의 배열 방식은 row-major로, OpenGL의 column-major와 반대이다.

easyar_Matrix44F easyar_InputFrame_cameraTransform(const easyar_InputFrame * This)
Matrix44F cameraTransform()
public @Nonnull Matrix44F cameraTransform()
fun cameraTransform(): Matrix44F
- (easyar_Matrix44F *)cameraTransform
public func cameraTransform() -> Matrix44F
public virtual Matrix44F cameraTransform()

반환 값

형식 설명
Matrix44F

cameraTransformType

카메라 변환 유형.

easyar_CameraTransformType easyar_InputFrame_cameraTransformType(const easyar_InputFrame * This)
CameraTransformType cameraTransformType()
public int cameraTransformType()
fun cameraTransformType(): Int
- (easyar_CameraTransformType)cameraTransformType
public func cameraTransformType() -> CameraTransformType
public virtual CameraTransformType cameraTransformType()

반환 값

형식 설명
CameraTransformType

trackingStatus

장치 모션 추적 상태 가져오기: MotionTrackingStatus

easyar_MotionTrackingStatus easyar_InputFrame_trackingStatus(const easyar_InputFrame * This)
MotionTrackingStatus trackingStatus()
public int trackingStatus()
fun trackingStatus(): Int
- (easyar_MotionTrackingStatus)trackingStatus
public func trackingStatus() -> MotionTrackingStatus
public virtual MotionTrackingStatus trackingStatus()

반환 값

형식 설명
MotionTrackingStatus

motion

운동 input 데이터

void easyar_InputFrame_motion(const easyar_InputFrame * This, easyar_OptionalOfMotionInputData * Return)
std::optional<std::shared_ptr<MotionInputData>> motion()
public @Nullable MotionInputData motion()
fun motion(): MotionInputData?
- (easyar_MotionInputData *)motion
public func motion() -> MotionInputData?
public virtual Optional<MotionInputData> motion()

반환 값

형식 설명
Optional<MotionInputData>

tryCreate

생성.

void easyar_InputFrame_tryCreate(easyar_Image * image, easyar_CameraParameters * cameraParameters, double timestamp, easyar_Matrix44F cameraTransform, easyar_CameraTransformType cameraTransformType, easyar_MotionTrackingStatus trackingStatus, easyar_OptionalOfInputFrame * Return)
static std::optional<std::shared_ptr<InputFrame>> tryCreate(std::shared_ptr<Image> image, std::shared_ptr<CameraParameters> cameraParameters, double timestamp, Matrix44F cameraTransform, CameraTransformType cameraTransformType, MotionTrackingStatus trackingStatus)
public static @Nullable InputFrame tryCreate(@Nonnull Image image, @Nonnull CameraParameters cameraParameters, double timestamp, @Nonnull Matrix44F cameraTransform, int cameraTransformType, int trackingStatus)
companion object fun tryCreate(image: Image, cameraParameters: CameraParameters, timestamp: Double, cameraTransform: Matrix44F, cameraTransformType: Int, trackingStatus: Int): InputFrame?
+ (easyar_InputFrame *)tryCreate:(easyar_Image *)image cameraParameters:(easyar_CameraParameters *)cameraParameters timestamp:(double)timestamp cameraTransform:(easyar_Matrix44F *)cameraTransform cameraTransformType:(easyar_CameraTransformType)cameraTransformType trackingStatus:(easyar_MotionTrackingStatus)trackingStatus
public static func tryCreate(_ image: Image, _ cameraParameters: CameraParameters, _ timestamp: Double, _ cameraTransform: Matrix44F, _ cameraTransformType: CameraTransformType, _ trackingStatus: MotionTrackingStatus) -> InputFrame?
public static Optional<InputFrame> tryCreate(Image image, CameraParameters cameraParameters, double timestamp, Matrix44F cameraTransform, CameraTransformType cameraTransformType, MotionTrackingStatus trackingStatus)

매개 변수

이름 형식 설명
image Image
cameraParameters CameraParameters
timestamp Double
cameraTransform Matrix44F
cameraTransformType CameraTransformType
trackingStatus MotionTrackingStatus

반환 값

형식 설명
Optional<InputFrame>

createWithImageAndCameraParametersAndTemporal

생성, 이미지, camera 파라미터 및 timestamp만 포함합니다.

void easyar_InputFrame_createWithImageAndCameraParametersAndTemporal(easyar_Image * image, easyar_CameraParameters * cameraParameters, double timestamp, easyar_InputFrame * * Return)
static std::shared_ptr<InputFrame> createWithImageAndCameraParametersAndTemporal(std::shared_ptr<Image> image, std::shared_ptr<CameraParameters> cameraParameters, double timestamp)
public static @Nonnull InputFrame createWithImageAndCameraParametersAndTemporal(@Nonnull Image image, @Nonnull CameraParameters cameraParameters, double timestamp)
companion object fun createWithImageAndCameraParametersAndTemporal(image: Image, cameraParameters: CameraParameters, timestamp: Double): InputFrame
+ (easyar_InputFrame *)createWithImageAndCameraParametersAndTemporal:(easyar_Image *)image cameraParameters:(easyar_CameraParameters *)cameraParameters timestamp:(double)timestamp
public static func createWithImageAndCameraParametersAndTemporal(_ image: Image, _ cameraParameters: CameraParameters, _ timestamp: Double) -> InputFrame
public static InputFrame createWithImageAndCameraParametersAndTemporal(Image image, CameraParameters cameraParameters, double timestamp)

매개 변수

이름 형식 설명
image Image
cameraParameters CameraParameters
timestamp Double

반환 값

형식 설명
InputFrame

createWithImageAndCameraParameters

생성, 이미지와 camera 파라미터만 포함합니다. 이 방법으로 생성된 입력은 CloudRecognizer에만 사용할 수 있으며, 다른 기능은 작동하지 않습니다.

void easyar_InputFrame_createWithImageAndCameraParameters(easyar_Image * image, easyar_CameraParameters * cameraParameters, easyar_InputFrame * * Return)
static std::shared_ptr<InputFrame> createWithImageAndCameraParameters(std::shared_ptr<Image> image, std::shared_ptr<CameraParameters> cameraParameters)
public static @Nonnull InputFrame createWithImageAndCameraParameters(@Nonnull Image image, @Nonnull CameraParameters cameraParameters)
companion object fun createWithImageAndCameraParameters(image: Image, cameraParameters: CameraParameters): InputFrame
+ (easyar_InputFrame *)createWithImageAndCameraParameters:(easyar_Image *)image cameraParameters:(easyar_CameraParameters *)cameraParameters
public static func createWithImageAndCameraParameters(_ image: Image, _ cameraParameters: CameraParameters) -> InputFrame
public static InputFrame createWithImageAndCameraParameters(Image image, CameraParameters cameraParameters)

매개 변수

이름 형식 설명
image Image
cameraParameters CameraParameters

반환 값

형식 설명
InputFrame

createWithImage

이미지만 포함하는 입력을 생성합니다. 이 방법으로 생성된 입력은 CloudRecognizer 에만 사용할 수 있으며, 다른 기능은 작동하지 않습니다.

void easyar_InputFrame_createWithImage(easyar_Image * image, easyar_InputFrame * * Return)
static std::shared_ptr<InputFrame> createWithImage(std::shared_ptr<Image> image)
public static @Nonnull InputFrame createWithImage(@Nonnull Image image)
companion object fun createWithImage(image: Image): InputFrame
+ (easyar_InputFrame *)createWithImage:(easyar_Image *)image
public static func createWithImage(_ image: Image) -> InputFrame
public static InputFrame createWithImage(Image image)

매개 변수

이름 형식 설명
image Image

반환 값

형식 설명
InputFrame