Table of Contents

Class ImageTarget

네임스페이스
easyar

ImageTarget은 평면 이미지의 target을 나타내며 ImageTracker가 추적할 수 있습니다. ImageTarget 내부의 값은 읽기 전에 먼저 create... 등의 메서드로 채워야 합니다. 그런 다음 loadTarget를 통해 ImageTracker에 성공적으로 로드된 후 ImageTracker가 감지하고 추적할 수 있습니다.

상속
ImageTarget

생성자

ImageTarget

void easyar_ImageTarget__ctor(easyar_ImageTarget * * Return)
ImageTarget()
public ImageTarget()
constructor()
+ (easyar_ImageTarget *) create
public convenience init()
public ImageTarget()

메서드

createFromParameters

파라미터에서 생성합니다.

void easyar_ImageTarget_createFromParameters(easyar_ImageTargetParameters * parameters, easyar_OptionalOfImageTarget * Return)
static std::optional<std::shared_ptr<ImageTarget>> createFromParameters(std::shared_ptr<ImageTargetParameters> parameters)
public static @Nullable ImageTarget createFromParameters(@Nonnull ImageTargetParameters parameters)
companion object fun createFromParameters(parameters: ImageTargetParameters): ImageTarget?
+ (easyar_ImageTarget *)createFromParameters:(easyar_ImageTargetParameters *)parameters
public static func createFromParameters(_ parameters: ImageTargetParameters) -> ImageTarget?
public static Optional<ImageTarget> createFromParameters(ImageTargetParameters parameters)

매개 변수

이름 형식 설명
parameters ImageTargetParameters

반환 값

형식 설명
Optional<ImageTarget>

createFromTargetFile

etd 파일에서 생성합니다.

void easyar_ImageTarget_createFromTargetFile(easyar_String * path, easyar_StorageType storageType, easyar_OptionalOfImageTarget * Return)
static std::optional<std::shared_ptr<ImageTarget>> createFromTargetFile(std::string path, StorageType storageType)
public static @Nullable ImageTarget createFromTargetFile(java.lang.@Nonnull String path, int storageType)
companion object fun createFromTargetFile(path: String, storageType: Int): ImageTarget?
+ (easyar_ImageTarget *)createFromTargetFile:(NSString *)path storageType:(easyar_StorageType)storageType
public static func createFromTargetFile(_ path: String, _ storageType: StorageType) -> ImageTarget?
public static Optional<ImageTarget> createFromTargetFile(string path, StorageType storageType)

매개 변수

이름 형식 설명
path String
storageType StorageType

반환 값

형식 설명
Optional<ImageTarget>

createFromTargetData

etd 데이터 버퍼에서 생성합니다.

void easyar_ImageTarget_createFromTargetData(easyar_Buffer * buffer, easyar_OptionalOfImageTarget * Return)
static std::optional<std::shared_ptr<ImageTarget>> createFromTargetData(std::shared_ptr<Buffer> buffer)
public static @Nullable ImageTarget createFromTargetData(@Nonnull Buffer buffer)
companion object fun createFromTargetData(buffer: Buffer): ImageTarget?
+ (easyar_ImageTarget *)createFromTargetData:(easyar_Buffer *)buffer
public static func createFromTargetData(_ buffer: Buffer) -> ImageTarget?
public static Optional<ImageTarget> createFromTargetData(Buffer buffer)

매개 변수

이름 형식 설명
buffer Buffer

반환 값

형식 설명
Optional<ImageTarget>

save

etd 파일로 저장합니다.

bool easyar_ImageTarget_save(easyar_ImageTarget * This, easyar_String * path)
bool save(std::string path)
public boolean save(java.lang.@Nonnull String path)
fun save(path: String): Boolean
- (bool)save:(NSString *)path
public func save(_ path: String) -> Bool
public virtual bool save(string path)

매개 변수

이름 형식 설명
path String

반환 값

형식 설명
Boolean

createFromImageFile

이미지에서 생성합니다. 필요하지 않은 경우 name, uid, meta는 빈 문자열을 전달할 수 있고 scale은 기본값 1을 사용할 수 있습니다. jpeg 또는 png 파일을 지원합니다.

void easyar_ImageTarget_createFromImageFile(easyar_String * path, easyar_StorageType storageType, easyar_String * name, easyar_String * uid, easyar_String * meta, float scale, easyar_OptionalOfImageTarget * Return)
static std::optional<std::shared_ptr<ImageTarget>> createFromImageFile(std::string path, StorageType storageType, std::string name, std::string uid, std::string meta, float scale)
public static @Nullable ImageTarget createFromImageFile(java.lang.@Nonnull String path, int storageType, java.lang.@Nonnull String name, java.lang.@Nonnull String uid, java.lang.@Nonnull String meta, float scale)
companion object fun createFromImageFile(path: String, storageType: Int, name: String, uid: String, meta: String, scale: Float): ImageTarget?
+ (easyar_ImageTarget *)createFromImageFile:(NSString *)path storageType:(easyar_StorageType)storageType name:(NSString *)name uid:(NSString *)uid meta:(NSString *)meta scale:(float)scale
public static func createFromImageFile(_ path: String, _ storageType: StorageType, _ name: String, _ uid: String, _ meta: String, _ scale: Float) -> ImageTarget?
public static Optional<ImageTarget> createFromImageFile(string path, StorageType storageType, string name, string uid, string meta, float scale)

매개 변수

이름 형식 설명
path String
storageType StorageType
name String
uid String
meta String
scale Single

반환 값

형식 설명
Optional<ImageTarget>

scale

이미지의 scale 비율입니다. 값은 이미지 너비의 물리적 크기와 1미터의 비율이며 기본값은 1입니다.

float easyar_ImageTarget_scale(const easyar_ImageTarget * This)
float scale()
public float scale()
fun scale(): Float
- (float)scale
public func scale() -> Float
public virtual float scale()

반환 값

형식 설명
Single

aspectRatio

이미지의 종횡비입니다.

float easyar_ImageTarget_aspectRatio(const easyar_ImageTarget * This)
float aspectRatio()
public float aspectRatio()
fun aspectRatio(): Float
- (float)aspectRatio
public func aspectRatio() -> Float
public virtual float aspectRatio()

반환 값

형식 설명
Single

setScale

이미지의 scale 비율을 설정합니다. 설정 후 기본값 및 json 파일에 설정된 값을 덮어씁니다. 값은 이미지 너비의 물리적 크기와 1미터의 비율이며 기본값은 1입니다. 이 모델 scale도 rendering engine에서 별도로 설정해야 합니다.

bool easyar_ImageTarget_setScale(easyar_ImageTarget * This, float scale)
bool setScale(float scale)
public boolean setScale(float scale)
fun setScale(scale: Float): Boolean
- (bool)setScale:(float)scale
public func setScale(_ scale: Float) -> Bool
public virtual bool setScale(float scale)

매개 변수

이름 형식 설명
scale Single

반환 값

형식 설명
Boolean

images

target에 저장된 이미지 목록을 가져옵니다. 일반적으로 이 메서드는 클라우드에서 반환된 target의 인식 이미지 데이터를 가져오는 데 사용됩니다.

void easyar_ImageTarget_images(easyar_ImageTarget * This, easyar_ListOfImage * * Return)
std::vector<std::shared_ptr<Image>> images()
public java.util.@Nonnull ArrayList<@Nonnull Image> images()
fun images(): ArrayList<Image>
- (NSArray<easyar_Image *> *)images
public func images() -> [Image]
public virtual List<Image> images()

반환 값

형식 설명
List<Image>

runtimeID

target id를 가져옵니다. target id는 runtime에 생성되는 정수 데이터이며 성공적으로 구성된 후에만 유효(non-zero)합니다. 이 id는 non-zero이며 전역적으로 증가합니다.

int easyar_ImageTarget_runtimeID(const easyar_ImageTarget * This)
int runtimeID()
public int runtimeID()
fun runtimeID(): Int
- (int)runtimeID
public override func runtimeID() -> Int32
public override int runtimeID()

반환 값

형식 설명
Int32

uid

target uid를 가져옵니다. ImageTarget의 uid는 cloud recognition 알고리즘에서 사용됩니다. cloud recognition을 통합하지 않은 경우 json 구성에서 이 uid를 설정하고 자신의 코드에서 target을 구분하는 또 다른 방법으로 사용할 수 있습니다.

void easyar_ImageTarget_uid(const easyar_ImageTarget * This, easyar_String * * Return)
std::string uid()
public java.lang.@Nonnull String uid()
fun uid(): String
- (NSString *)uid
public override func uid() -> String
public override string uid()

반환 값

형식 설명
String

name

target name을 가져옵니다. name은 json 파일에서 target을 구분하는 데 사용됩니다.

void easyar_ImageTarget_name(const easyar_ImageTarget * This, easyar_String * * Return)
std::string name()
public java.lang.@Nonnull String name()
fun name(): String
- (NSString *)name
public override func name() -> String
public override string name()

반환 값

형식 설명
String

setName

target name을 설정합니다. 이 작업은 이전 설정 또는 서버가 반환한 데이터를 덮어씁니다.

void easyar_ImageTarget_setName(easyar_ImageTarget * This, easyar_String * name)
void setName(std::string name)
public void setName(java.lang.@Nonnull String name)
fun setName(name: String): Unit
- (void)setName:(NSString *)name
public override func setName(_ name: String) -> Void
public override void setName(string name)

매개 변수

이름 형식 설명
name String

반환 값

형식 설명
Void

meta

setMetaData로 설정한 meta data를 가져옵니다. 또는 cloud recognition에서 반환된 target에서 서버가 설정한 meta data를 가져옵니다.

void easyar_ImageTarget_meta(const easyar_ImageTarget * This, easyar_String * * Return)
std::string meta()
public java.lang.@Nonnull String meta()
fun meta(): String
- (NSString *)meta
public override func meta() -> String
public override string meta()

반환 값

형식 설명
String

setMeta

meta data를 설정합니다. 이 작업은 이전 설정 또는 서버가 반환한 데이터를 덮어씁니다.

void easyar_ImageTarget_setMeta(easyar_ImageTarget * This, easyar_String * data)
void setMeta(std::string data)
public void setMeta(java.lang.@Nonnull String data)
fun setMeta(data: String): Unit
- (void)setMeta:(NSString *)data
public override func setMeta(_ data: String) -> Void
public override void setMeta(string data)

매개 변수

이름 형식 설명
data String

반환 값

형식 설명
Void