Table of Contents

Class ObjectTarget

Пространство имен
easyar

ObjectTarget представляет 3D object target, который может отслеживаться ObjectTracker. Размер ObjectTarget определяется файлом obj. Размер можно изменить, изменив scale. scale по умолчанию равен 1. После успешной загрузки ObjectTarget в ObjectTracker через loadTarget он может обнаруживаться и отслеживаться ObjectTracker.

Наследование
ObjectTarget

Конструкторы

ObjectTarget

void easyar_ObjectTarget__ctor(easyar_ObjectTarget * * Return)
ObjectTarget()
public ObjectTarget()
constructor()
+ (easyar_ObjectTarget *) create
public convenience init()
public ObjectTarget()

Методы

createFromParameters

Создает из параметров.

void easyar_ObjectTarget_createFromParameters(easyar_ObjectTargetParameters * parameters, easyar_OptionalOfObjectTarget * Return)
static std::optional<std::shared_ptr<ObjectTarget>> createFromParameters(std::shared_ptr<ObjectTargetParameters> parameters)
public static @Nullable ObjectTarget createFromParameters(@Nonnull ObjectTargetParameters parameters)
companion object fun createFromParameters(parameters: ObjectTargetParameters): ObjectTarget?
+ (easyar_ObjectTarget *)createFromParameters:(easyar_ObjectTargetParameters *)parameters
public static func createFromParameters(_ parameters: ObjectTargetParameters) -> ObjectTarget?
public static Optional<ObjectTarget> createFromParameters(ObjectTargetParameters parameters)

Параметры

Имя Тип Описание
parameters ObjectTargetParameters

Возвращаемое значение

Тип Описание
Optional<ObjectTarget>

createFromObjectFile

Создает из файлов obj, mtl и jpg/png.

void easyar_ObjectTarget_createFromObjectFile(easyar_String * path, easyar_StorageType storageType, easyar_String * name, easyar_String * uid, easyar_String * meta, float scale, easyar_OptionalOfObjectTarget * Return)
static std::optional<std::shared_ptr<ObjectTarget>> createFromObjectFile(std::string path, StorageType storageType, std::string name, std::string uid, std::string meta, float scale)
public static @Nullable ObjectTarget createFromObjectFile(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 createFromObjectFile(path: String, storageType: Int, name: String, uid: String, meta: String, scale: Float): ObjectTarget?
+ (easyar_ObjectTarget *)createFromObjectFile:(NSString *)path storageType:(easyar_StorageType)storageType name:(NSString *)name uid:(NSString *)uid meta:(NSString *)meta scale:(float)scale
public static func createFromObjectFile(_ path: String, _ storageType: StorageType, _ name: String, _ uid: String, _ meta: String, _ scale: Float) -> ObjectTarget?
public static Optional<ObjectTarget> createFromObjectFile(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<ObjectTarget>

scale

Коэффициент scale модели. Его значение является отношением физического размера модели в пространстве к ее размеру в системе координат модели. Значение по умолчанию равно 1. (Предполагается, что единица масштаба в системе координат модели — метр.)

float easyar_ObjectTarget_scale(const easyar_ObjectTarget * This)
float scale()
public float scale()
fun scale(): Float
- (float)scale
public func scale() -> Float
public virtual float scale()

Возвращаемое значение

Тип Описание
Single

boundingBox

Ограничивающий объем объекта, включая 8 вершин коробки. Индексы вершин определены следующим образом:

  4-----7
 /|    /|
5-----6 |    z
| |   | |    |
| 0---|-3    o---y
|/    |/    /
1-----2    x
void easyar_ObjectTarget_boundingBox(easyar_ObjectTarget * This, easyar_ListOfVec3F * * Return)
std::vector<Vec3F> boundingBox()
public java.util.@Nonnull ArrayList<@Nonnull Vec3F> boundingBox()
fun boundingBox(): ArrayList<Vec3F>
- (NSArray<easyar_Vec3F *> *)boundingBox
public func boundingBox() -> [Vec3F]
public virtual List<Vec3F> boundingBox()

Возвращаемое значение

Тип Описание
List<Vec3F>

setScale

Устанавливает коэффициент scale модели. После установки он переопределяет значение по умолчанию и значение, заданное в json-файле. Его значение является отношением физического размера модели в пространстве к ее размеру в системе координат модели. Значение по умолчанию равно 1. (Предполагается, что единица масштаба в системе координат модели — метр.) Этот scale модели также нужно отдельно установить в rendering engine. Обратите внимание, что эта настройка должна быть выполнена до загрузки в ObjectTracker через loadTarget.

bool easyar_ObjectTarget_setScale(easyar_ObjectTarget * 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

runtimeID

Получает target id. target id — целочисленные данные, созданные во время runtime, и он действителен (non-zero) только после успешной конфигурации. Этот id non-zero и глобально увеличивается.

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

Возвращаемое значение

Тип Описание
Int32

uid

Получает target uid. uid у ImageTarget используется в алгоритме cloud recognition. Если cloud recognition не подключено, вы можете задать этот uid в json-конфигурации и использовать его в своем коде как другой способ различать target.

void easyar_ObjectTarget_uid(const easyar_ObjectTarget * 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 используется для различения target в json-файле.

void easyar_ObjectTarget_name(const easyar_ObjectTarget * 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_ObjectTarget_setName(easyar_ObjectTarget * 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

Получает meta data, заданные setMetaData. Или, в target, возвращенном cloud recognition, получает meta data, заданные сервером.

void easyar_ObjectTarget_meta(const easyar_ObjectTarget * 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_ObjectTarget_setMeta(easyar_ObjectTarget * 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