Class ImageTarget

네임스페이스

easyar

ImageTarget은 평면 이미지의 타겟을 나타내며, ImageTracker에 의해 추적될 수 있습니다.
ImageTarget 내부의 데이터는 읽기 전에 먼저 create... 등의 메서드를 통해 채워져야 합니다. 이후 ImageTracker에 loadTarget을 통해 성공적으로 로드된 후에야 ImageTracker에 의해 감지 및 추적될 수 있습니다.

상속

Target

ImageTarget

생성자

ImageTarget

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ImageTarget__ctor(easyar_ImageTarget * * Return)

ImageTarget()

public ImageTarget()

constructor()

+ (easyar_ImageTarget *) create

public convenience init()

public ImageTarget()

메서드

createFromParameters

파라미터로부터 생성

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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 파일에서 생성

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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 데이터 캐시에서 생성.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

한국어로 번역: 저장을 엣디 파일로.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

이미지로부터 생성합니다. 필요하지 않은 경우 이름, UID, 메타는 빈 문자열을 전달할 수 있으며 스케일은 기본값 1을 전달할 수 있습니다. JPEG 또는 PNG 파일을 지원합니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

이미지의 확대/축소 비율입니다. 이 값은 이미지 너비의 물리적 크기와 1미터에 대한 비율을 나타내며, 기본값은 1입니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

이미지의 가로세로비(Aspect ratio).

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

이미지의 스케일을 설정합니다. 설정 후에는 기본값 및 json 파일에 설정된 값을 덮어쓰게 됩니다. 그 값은 이미지 너비의 물리적 크기와 1미터의 비율이며, 기본값은 1입니다.
또한 이 모델 스케일을 렌더링 엔진에서 별도로 설정해야 합니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

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

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

대상 ID를 가져옵니다. 대상 ID는 런타임에 생성된 정수형 데이터로, 성공적인 구성 이후에만 유효(0이 아닌)합니다. 이 ID는 0이 아니며 전역적으로 증가합니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

대상 UID 획득. ImageTarget의 UID는 클라우드 인식 알고리즘에서 사용됩니다. 클라우드 인식에 접속하지 않은 상태에서는 JSON 설정에서 이 UID를 지정할 수 있으며, 사용자 코드에서 대상을 구분하는 또 다른 방법으로 활용할 수 있습니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

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

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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

대상 이름을 설정합니다. 이 작업은 이전 설정이나 서버에서 반환된 데이터를 덮어씁니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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로 설정된 메타 데이터를 가져옵니다. 또는 클라우드 인식에서 반환된 target에서 서버가 설정한 메타 데이터를 획득합니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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를 설정합니다. 이 작업은 이전 설정이나 서버에서 반환된 데이터를 덮어쓰게 됩니다.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

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