Table of Contents

Class ObjectTarget

名前空間
easyar

ObjectTarget は 3D object target を表し、ObjectTracker によってトラッキングできます。 ObjectTarget のサイズは obj ファイルによって決まります。scale を変更することで size を変更できます。scale のデフォルトは 1 です。 ObjectTarget が loadTarget によって ObjectTracker に正常にロードされた後、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 でも別途設定する必要があります。 この設定は loadTarget によって ObjectTracker にロードする前に行う必要があることに注意してください。

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 を取得します。ImageTarget の uid は 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 は json ファイル内で target を区別するために使用されます。

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

setMetaData で設定された meta data を取得します。または、cloud recognition から返された target で、サーバーが設定した 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