Table of Contents

Class InputFrame

네임스페이스
easyar

Input frame입니다. image, camera parameters, timestamp, world coordinate system에 대한 camera transform 및 tracking status를 포함합니다. 이 중 camera parameters, timestamp, world coordinate system에 대한 camera transform 및 tracking status는 선택 사항이지만, 특정 알고리즘 컴포넌트는 input에 대한 특정 요구 사항이 있습니다.

InputFrame

메서드

index

Index이며, 각 input frame마다 다른 자동 증가 값입니다.

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

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

camera parameters가 포함되어 있는지 여부입니다.

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

camera parameters를 가져옵니다.

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

시간 정보(timestamp)가 포함되어 있는지 여부입니다.

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

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

world coordinate system에 대한 camera의 transform입니다. camera coordinate system과 world coordinate system은 모두 오른손 좌표계입니다. Camera coordinate system의 origin은 camera optical center이고, x축 양의 방향은 오른쪽, y축 양의 방향은 위쪽, z축 양의 방향은 빛이 camera로 들어가는 방향입니다. (여기서 오른쪽과 위쪽은 camera image에서의 오른쪽과 위쪽을 의미하며 natural device orientation과 다를 수 있습니다.) 데이터 배열 방식은 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

Camera transform type입니다.

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

device motion tracking status를 가져옵니다: 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

Motion input data입니다.

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

생성하며, image, camera parameters 및 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) throws -> InputFrame
public static InputFrame createWithImageAndCameraParametersAndTemporal(Image image, CameraParameters cameraParameters, double timestamp)

매개 변수

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

반환 값

형식 설명
InputFrame

createWithImageAndCameraParameters

생성하며, image와 camera parameters만 포함합니다. 이 메서드로 생성한 input은 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) throws -> InputFrame
public static InputFrame createWithImageAndCameraParameters(Image image, CameraParameters cameraParameters)

매개 변수

이름 형식 설명
image Image
cameraParameters CameraParameters

반환 값

형식 설명
InputFrame

createWithImage

생성하며, image만 포함합니다. 이 메서드로 생성한 input은 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) throws -> InputFrame
public static InputFrame createWithImage(Image image)

매개 변수

이름 형식 설명
image Image

반환 값

형식 설명
InputFrame