Vp object add - Revision history

Sleepy E: Added reference number attribute

2018-07-31T23:14:05Z

Added reference number attribute

← Older revision		Revision as of 23:14, 31 July 2018
Line 2:		Line 2:
	\|parameters=		\|parameters=
	\|attributes=		\|attributes=
			{{sdk attribute row\|int \|reference_number \|Is passed to the callback to identify for which method call it is fired}}
	{{sdk attribute row\|int \|object_type \|Type of object (0 - 3D Model, 2 - Particle emitter, 3 - Path object) }}		{{sdk attribute row\|int \|object_type \|Type of object (0 - 3D Model, 2 - Particle emitter, 3 - Path object) }}
	{{sdk attribute row\|float \|object_x \|X coordinate}}		{{sdk attribute row\|float \|object_x \|X coordinate}}

Sleepy E at 21:31, 17 December 2016

2016-12-17T21:31:11Z

← Older revision		Revision as of 21:31, 17 December 2016
Line 22:		Line 22:
	{{sdk attribute row\|int\|object_id\|Object id that was assigned to the new object}}		{{sdk attribute row\|int\|object_id\|Object id that was assigned to the new object}}
	\|behavior=		\|behavior=
	* Upon successful creation of an object, {{sdk event\|OBJECT}} is triggered for those who have subscribed to it.		* Upon successful creation of an object, {{sdk event\|OBJECT}} is triggered for those who have subscribed to it. See {{sdk method\|event_set}}.
	* If {{sdk attribute\|object_rotation_angle}} is set to INFINITY then it will be stored as that in world. The euler angles will be not be converted to an equivalent axis-angle representation. See examples for euler to axis-angle conversion code.		* If {{sdk attribute\|object_rotation_angle}} is set to INFINITY then it will be stored as that in world. The euler angles will be not be converted to an equivalent axis-angle representation. See examples for euler to axis-angle conversion code.
	\|caveats=		\|caveats=

Sleepy E: Added example for axis-angle to euler conversion

2016-12-17T11:51:41Z

Added example for axis-angle to euler conversion

@@ Line 62: / Line 62: @@
 </syntaxhighlight>
-Convert euler angles (in degrees) to axis-angle representation.
+Convert euler angles (in degrees) to axis-angle.
 <syntaxhighlight lang="c">
-void rotate(double yaw, double pitch, double roll, double *x, double *y, double *z, double *angle)
+void euler_to_axis_angle(double yaw, double pitch, double roll, double *x, double *y, double *z, double *angle)
+{
    // Convert angles to radians
@@ Line 107: / Line 107: @@
    *angle = 2 * acos(cos_yaw_2 * cos_pitch_2 * cos_roll_2 - sin_yaw_2 * sin_pitch_2 * sin_roll_2);
+}
 </syntaxhighlight>

Sleepy E: Added euler to angle-axis conversion code

2016-12-16T23:03:58Z

Added euler to angle-axis conversion code

@@ Line 23: / Line 23: @@
 |behavior=
 * Upon successful creation of an object, {{sdk event|OBJECT}} is triggered for those who have subscribed to it.
 |caveats=
 |examples=
@@ Line 58: / Line 59: @@
    //...
+}
 </syntaxhighlight>

Sleepy E at 21:58, 16 December 2016

2016-12-16T21:58:07Z

← Older revision		Revision as of 21:58, 16 December 2016
Line 10:		Line 10:
	{{sdk attribute row\|float \|object_rotation_z \|Rotation Z axis}}		{{sdk attribute row\|float \|object_rotation_z \|Rotation Z axis}}
	{{sdk attribute row\|float \|object_rotation_angle \|Rotation angle in radians}}		{{sdk attribute row\|float \|object_rotation_angle \|Rotation angle in radians}}
	{{sdk attribute row\|float \|object_yaw \|Yaw angle in degrees (these are used instead of X,Y,Z axis when rotation angle is set to ~~INFINITE~~)}}		{{sdk attribute row\|float \|object_yaw \|Yaw angle in degrees (these are used instead of X,Y,Z axis when rotation angle is set to INFINITY)}}
	{{sdk attribute row\|float \|object_pitch \|Pitch angle in degrees}}		{{sdk attribute row\|float \|object_pitch \|Pitch angle in degrees}}
	{{sdk attribute row\|float \|object_roll \|Roll angle in degrees}}		{{sdk attribute row\|float \|object_roll \|Roll angle in degrees}}

Sleepy E: Add example, some information on attributes

2016-12-16T21:55:49Z

Add example, some information on attributes

← Older revision		Revision as of 21:55, 16 December 2016
Line 2:		Line 2:
	\|parameters=		\|parameters=
	\|attributes=		\|attributes=
	{{sdk attribute row\|int \|~~OBJECT_TYPE~~ \|Type of object}}		{{sdk attribute row\|int \|object_type \|Type of object (0 - 3D Model, 2 - Particle emitter, 3 - Path object) }}
	{{sdk attribute row\|float \|~~OBJECT_X~~ \|X coordinate}}		{{sdk attribute row\|float \|object_x \|X coordinate}}
	{{sdk attribute row\|float \|~~OBJECT_Y~~ \|Y coordinate}}		{{sdk attribute row\|float \|object_y \|Y coordinate}}
	{{sdk attribute row\|float \|~~OBJECT_Z~~ \|Z coordinate}}		{{sdk attribute row\|float \|object_z \|Z coordinate}}
	{{sdk attribute row\|float \|~~OBJECT_ROTATION_X~~ \|Rotation axis X}}		{{sdk attribute row\|float \|object_rotation_x \|Rotation X axis}}
	{{sdk attribute row\|float \|~~OBJECT_ROTATION_Y~~ \|Rotation axis Y}}		{{sdk attribute row\|float \|object_rotation_y \|Rotation Y axis}}
	{{sdk attribute row\|float \|~~OBJECT_ROTATION_Z~~ \|Rotation axis Z}}		{{sdk attribute row\|float \|object_rotation_z \|Rotation Z axis}}
	{{sdk attribute row\|float \|~~OBJECT_ROTATION_ANGLE~~ \|~~Rotation~~ angle}}		{{sdk attribute row\|float \|object_rotation_angle \|Rotation angle in radians}}
	{{sdk attribute row\|string \|~~OBJECT_MODEL~~ \|Model}}		{{sdk attribute row\|float \|object_yaw \|Yaw angle in degrees (these are used instead of X,Y,Z axis when rotation angle is set to INFINITE)}}
	{{sdk attribute row\|string \|~~OBJECT_ACTION~~ \|Action}}		{{sdk attribute row\|float \|object_pitch \|Pitch angle in degrees}}
	{{sdk attribute row\|string \|~~OBJECT_DESCRIPTION~~ \|Description}}		{{sdk attribute row\|float \|object_roll \|Roll angle in degrees}}
	{{sdk attribute row\|data \|~~OBJECT_DATA~~ \|Data}}		{{sdk attribute row\|string \|object_model \|Model}}
			{{sdk attribute row\|string \|object_action \|Action}}
			{{sdk attribute row\|string \|object_description \|Description}}
			{{sdk attribute row\|data \|object_data \|Data}}
	\|returncodes=		\|returncodes=
	{{sdk return code row\|~~NOT_IN_WORLD~~ \|Bot is not currently in a world}}		{{sdk return code row\|not_in_world\|Bot is not currently in a world}}
	\|returnattributes=		\|returnattributes=
	{{sdk attribute row\|int\|~~OBJECT_ID~~\|Object id}}		{{sdk attribute row\|int\|object_id\|Object id that was assigned to the new object}}
	\|behavior=		\|behavior=
	* Upon successful creation of an object, {{sdk event\|OBJECT}} is triggered for those who have subscribed to it.		* Upon successful creation of an object, {{sdk event\|OBJECT}} is triggered for those who have subscribed to it.
	\|caveats=		\|caveats=
	\|examples=		\|examples=
			Build a street1.rwx object at 0X 0Y 0Z.
			<syntaxhighlight lang="c">
			void handle_object_add(VPInstance sdk, int rc, int ref)
			{
			if (rc)
			printf("Couldn't build object (reason %d)\n", rc);
			else
			printf("Object built successfully!\n");
			}

			int main(int argc, const char* argv[])
			{
			//...

			vp_callback_set(sdk, VP_CALLBACK_OBJECT_ADD, handle_object_add);

			vp_int_set(sdk, VP_OBJECT_TYPE, 0); // 3D Model
			vp_float_set(sdk, VP_OBJECT_X, 0.0);
			vp_float_set(sdk, VP_OBJECT_Y, 0.0);
			vp_float_set(sdk, VP_OBJECT_Z, 0.0);
			vp_float_set(sdk, VP_OBJECT_ROTATION_X, 0.0);
			vp_float_set(sdk, VP_OBJECT_ROTATION_Y, 0.0);
			vp_float_set(sdk, VP_OBJECT_ROTATION_Z, 0.0);
			vp_float_set(sdk, VP_OBJECT_ROTATION_ANGLE, 0.0);
			vp_string_set(sdk, VP_OBJECT_MODEL, "street1.rwx");
			vp_string_set(sdk, VP_OBJECT_ACTION, "");
			vp_string_set(sdk, VP_OBJECT_DESCRIPTION, "");

			rc = vp_object_add(sdk);
			if (rc)
			printf("Couldn't build object (reason %d)\n", rc);

			//...
			}
			</syntaxhighlight>
	\|seealso=		\|seealso=
	* {{sdk method\|object_change}}		* {{sdk method\|object_change}}
	* {{sdk method\|object_delete}}		* {{sdk method\|object_delete}}
	* {{sdk callback\|~~OBJECT_ADD~~}}		* {{sdk callback\|object_add}}
	}}		}}

Sleepy E at 09:56, 13 December 2016

2016-12-13T09:56:51Z

← Older revision		Revision as of 09:56, 13 December 2016
Line 19:		Line 19:
	{{sdk attribute row\|int\|OBJECT_ID\|Object id}}		{{sdk attribute row\|int\|OBJECT_ID\|Object id}}
	\|behavior=		\|behavior=
			* Upon successful creation of an object, {{sdk event\|OBJECT}} is triggered for those who have subscribed to it.
	\|caveats=		\|caveats=
	\|examples=		\|examples=

Sleepy E at 09:30, 13 December 2016

2016-12-13T09:30:04Z

← Older revision		Revision as of 09:30, 13 December 2016
Line 22:		Line 22:
	\|examples=		\|examples=
	\|seealso=		\|seealso=
			* {{sdk method\|object_change}}
			* {{sdk method\|object_delete}}
			* {{sdk callback\|OBJECT_ADD}}
	}}		}}

Sleepy E: Basic layout

2016-12-13T09:28:58Z

Basic layout

New page

{{sdk method page|object_add|Build a new object.
|parameters=
|attributes=
{{sdk attribute row|int |OBJECT_TYPE |Type of object}}
{{sdk attribute row|float |OBJECT_X |X coordinate}}
{{sdk attribute row|float |OBJECT_Y |Y coordinate}}
{{sdk attribute row|float |OBJECT_Z |Z coordinate}}
{{sdk attribute row|float |OBJECT_ROTATION_X |Rotation axis X}}
{{sdk attribute row|float |OBJECT_ROTATION_Y |Rotation axis Y}}
{{sdk attribute row|float |OBJECT_ROTATION_Z |Rotation axis Z}}
{{sdk attribute row|float |OBJECT_ROTATION_ANGLE |Rotation angle}}
{{sdk attribute row|string |OBJECT_MODEL |Model}}
{{sdk attribute row|string |OBJECT_ACTION |Action}}
{{sdk attribute row|string |OBJECT_DESCRIPTION |Description}}
{{sdk attribute row|data |OBJECT_DATA |Data}}
|returncodes=
{{sdk return code row|NOT_IN_WORLD |Bot is not currently in a world}}
|returnattributes=
{{sdk attribute row|int|OBJECT_ID|Object id}}
|behavior=
|caveats=
|examples=
|seealso=
}}

← Older revision		Revision as of 21:58, 16 December 2016
Line 10:		Line 10:
	{{sdk attribute row\|float \|object_rotation_z \|Rotation Z axis}}		{{sdk attribute row\|float \|object_rotation_z \|Rotation Z axis}}
	{{sdk attribute row\|float \|object_rotation_angle \|Rotation angle in radians}}		{{sdk attribute row\|float \|object_rotation_angle \|Rotation angle in radians}}
	{{sdk attribute row\|float \|object_yaw \|Yaw angle in degrees (these are used instead of X,Y,Z axis when rotation angle is set to ~~INFINITE~~)}}		{{sdk attribute row\|float \|object_yaw \|Yaw angle in degrees (these are used instead of X,Y,Z axis when rotation angle is set to INFINITY)}}
	{{sdk attribute row\|float \|object_pitch \|Pitch angle in degrees}}		{{sdk attribute row\|float \|object_pitch \|Pitch angle in degrees}}
	{{sdk attribute row\|float \|object_roll \|Roll angle in degrees}}		{{sdk attribute row\|float \|object_roll \|Roll angle in degrees}}