Skip to main content
Samsung Developer Program

Gyro

You can use the Gyro Effect property to create dynamic watch faces that change based on the watch's tilt position and angle. You can modify the X and Y rotation dimensions of objects independently to create 3D effects for your watch face. 

gyroEffects.PNG
 

Find the Gyro Effect property under Component > Complications > Effect >  Gyro_Effect_Sample_Dance

gyroEffectLocationinGWD.png

Gyro Effect allows you to adjust the dimensions, inner pivot positions, rotation, and opacity of objects in your watch face (see the following illustration).

gyroEffectTab-1.png

gyroscope_x-y-axes.png
 

  • Gyro effects are applied as the watch moves within the -90º to 90º range along the X and Y axes. 0º indicates that the watch is level.
  • You can design watch faces to change appearance when the watch moves clockwise or counterclockwise.
    gyroscope_rotational.png
     
  • -90º on the X axis indicates that the watch has rotated  90º upward along the X axis, counterclockwise. Conversely, 90º indicates that the watch has rotated 90º downward along the X axis, clockwise (see below).

    rotateUpandDown.png

  • -90º on the Y axis indicates that the watch has rotated 90º to the left, counterclockwise. Conversely, 90º on the Y axis indicates that the watch has rotated 90º to the right, clockwise (see below).
    rotate-onYaxis.png

Before you enter a value in any Gyro input field, consider the object’s position and anticipate its dimension changes. Place the object to see how it looks and where it is located at -90 or +90. Then enter the difference value into the appropriate Gyro field so that the object reaches the end position you want.

rotation.png

Change inner pivot positions

  • You can enter the value for each property from -90° to +90°.
  • The absolute value that you enter must be same for both sides; for example, pivot X cannot use -90 and +45, it must use -45 and +45.
  •  The value you enter determines how much the actual value would change with respect to the base value. The actual value is calculated through linear interpolation.
    gyroIndieProperties.png
  • Of the three different tabs (Gyro XY, Gyro X, Gyro Y) used to apply gyro effects, Gyro XY properties are always applied, regardless of the axis of rotation.

Note: You can only change each property in one tab. For example, if a Rotation value is entered in the Gyro X tab, then the Rotation value cannot be entered in the Gyro Y or Gyro XY tabs.

The Gyro X and Gyro Y tabs allow you to control the properties when the watch rotates along the X and Y axes, respectively, so you can use these Gyro properties independently to create a variety of interesting effects.

Dimension

The Dimension property allows you to change the view angle of your watch face.

When the watch is flat with no tilt in any direction (0º along both the X and Y axes), the watch face dimension values are at 100% (see 1 in the following illustration):

dimensionProperty.png

  • Any movement downward or to the right incrementally increases this percentage to a maximum of 200%.
  • Any movement upwards or to the left will decrease this percentage down to a minimum of 0%.

Regarding the example shown in the illustration:

  1. If the watch rotates -90º along the X axis or -90º along the Y axis, the object shrinks and disappears from the screen (0%).
  2. If the watch rotates 90º along the X axis or 90º along the Y axis, the object doubles in size in that direction (200%).
  3. If the watch rotates along both the X and Y axes, the properties entered for both axes are applied simultaneously. If the watch rotates in opposite directions along the X and Y axes, then the object stretches vertically or horizontally.
  4. If the watch rotates in the same direction along the X and Y axes, then the object increases or decreases in size.

Resize

Enlarge and shrink an object in relation to a point at its center. The point remains in the same position as the object gets bigger or smaller.

gyroResize.png

Move

You can change the position of an object using its center point by configuring the Position input field value.

gyroMove.png

Rotation

You can rotate an object based on its point. Note that rotation does not change the position of the object.

gyroRotation.png

  • Was this article helpful?