Model Class
A Model drawable represents an ARObject as a 3D Model.
A Model file consist of a link to a WT3 file that is created using the Wikitude 3D Encoder,
as well as certain control properties and triggers that fire on certain events. You can find out more about 3D in the Wikitude SDK documentation.
3D content is rendered on top of 2D objects. This limitation exists because of some SDK internal restrictions and might change in an upcoming release.
On creation, setup parameters can be passed to customize the properties of
the Model.
//create a new Model and pass some setup parameters var model = new AR.Model("models/my3dModel.wt3", { // scales it to half of the original size scale: { x: 0.5, y: 0.5, z: 0.5 }, // rotates it 90 degrees around the z-axis and 180 degrees around the x-axis rotate: { roll: 90.0, tilt: 180.0, heading: 0.0 }, // moves the 0bject 5 SDUs along the x- and the y-axis translate: { x: 5, y: 5, z: 0 }, onClick : function() { //something happens } });
Constructor
Model
-
uri
-
options
Parameters:
-
uri
StringAn URI pointing to the zip file including all model information/a>
-
options
Object optionalSetup-Parameters to customize additional object properties.
Accepted options-properties are-
enabled
(defaults totrue
) Boolean optional -
horizontalAnchor
Number optional -
rotate.roll
(defaults to0
) Number optional -
rotate.tilt
(defaults to0
) Number optional -
rotate.heading
(defaults to0
) Number optional -
scale.x
(defaults to1
) Number optional -
scale.y
(defaults to1
) Number optional -
scale.z
(defaults to1
) Number optional -
translate.x
(defaults to0
) Number optional -
translate.y
(defaults to0
) Number optional -
translate.z
(defaults to0
) Number optional -
onClick
Function optional -
onLoaded
Function optional -
onError
Function optional
-
Item Index
Properties
- destroyed
- enabled
- heading deprecated
- roll deprecated
- rotate.heading
- rotate.roll
- rotate.tilt
- scale.x
- scale.y
- scale.z
- tilt deprecated
- translate.x
- translate.y
- translate.z
- uri
Events
- onClick
- onError
- onLoaded
- triggers.onClick deprecated
Methods
destroy
()
Destroys the object.
Properties
enabled
Boolean
Flag to enable/disable the Drawable. If the Drawable is disabled, it will never appear on the screen and triggers on this Drawable will never be fired. In case it is enabled, it can be rendered on the screen and fire triggers.
Default: true
rotate.heading
Number
Defines a rotation of the Drawable around the y-axis, specified in degrees. Values will be applied modulo 360. A value of 361 degrees has the same effect as setting the value to 1 degree.
Default: 0
rotate.roll
Number
Defines a rotation of the Drawable around the z-axis, specified in degrees. Values will be applied modulo 360. A value of 361 degrees has the same effect as setting the value to 1 degree.
Default: 0
rotate.tilt
Number
Defines a rotation of the Drawable around the x-axis, specified in degrees. Values will be applied modulo 360. A value of 361 degrees has the same effect as setting the value to 1 degree.
Default: 0
translate.x
Number
The horizontal offset to the calculated position of the Model, in SDUs. A positive x causes the Model to move right, a negative offsetX causes it to move left.
Default: 0
translate.y
Number
The vertical offset to the calculated position of the Model, in SDUs. A positive y causes the Model to move up, a negative offsetX causes it to move down.
Default: 0
translate.z
Number
The depth-offset to the calculated position of the Model, in SDUs. A positive z causes the Model to move towards the user, a negative offsetX causes it to move away.
Default: 0
uri
String
The uri pointing to the model file. This property is read-only and cannot be modified after creation.
Events
onClick
When the Drawable is clicked, the system will trigger Drawable.onClick(ARObject). A click on the screen might hit multiple Drawables, thus a click creates a "clicked Drawables-queue", with the uppermost Drawable in the front of the queue. The return value of the function determines if, after the onClick()-Function was executed for this Drawable, the queue shall continue to execute onClick() for the next Drawable in the queue. In case the last Drawable in the queue still requests to continue the click-queue, ARObject.onClick() will be executed. If the queue still continues, context.onScreenClick() will be executed.
The return value of the function determines what happens next. If false, the click-queue should not stop with this Drawable. Thus, the next Drawable's onClick() function will be executed. This is the default value in case no return value is set or the function is not defined for this Drawable. If true, the queue-execution will stop at the current Drawable, underlying Drawables will not receive onClick() calls.
Event Payload:
-
arObject
ARObjectthe ARObject the clicked Drawable is attached to.
The trigger is null by default, and will thus result in no action executed when the trigger fires. A developer can add custom functionality by assigning a custom function to onClick.
onError
The trigger will fire when the Model file cannot be loaded.
The trigger is null by default, and will thus result in no action executed when the trigger fires. A developer can add custom functionality by assigning a custom function to onLoaded.
onLoaded
The trigger will fire when the Model file is successfully loaded.
The trigger is null by default, and will thus result in no action executed when the trigger fires. A developer can add custom functionality by assigning a custom function to onLoaded.