Skip to content
Linear

Motion
Demo
Demo

.linear()


Description

Calculates and return a linear interpolation based on an incremental input

Although very similar to the other easing Methods, the output value is by default a linear interpolation between 0.0 and 1.0 or in case start and stop parameter are being passed as aguments, the output will be an interpolation between those two given values.

The counter parameter should be tuned according to the totalLength e.g. if the total totalLength value was set to 3.0 seconds, the counter parameter should be an incremental value between 0.0 and 3.0 in order to complete one motion cycle.

Like for the Easing Methods there are three kind of cycling behaviour: either "loop" "alternate" or "once", and when combined with an incremental counter parameter, the output will variate.

  • "loop" the motion will loop from 0 to 1 (this is is the default option);
    note: the function expects the counter to be between 0.0 and totalLength

  • "alternate" the motion goes from 0 to 1, then inverts from 1 back to 0, alternatively.
    note: the function expects the counter to be between 0.0 and twice the totalLength

  • "once" the motion cycle from from 0 to 1 only once


Example:

linear_tool.pde
import easy.ease.*;

float intensity = 4.0;
float totalLength = 2;
float span = 1.5;
float delay = 0.25;
EasyEase curve = new EasyEase(this);

void setup() {
  size(600, 400);
  curve.setTotalLength(totalLength);
}

void draw() {
  background(#f1f1f1);
  fill(#ff0000);

  float mot_counter = curve.framer(frameCount);
  float x = curve.linear(mot_counter ) * (width) -50;
  rect(x, 0, 100, width);
  rec(30,120);
}

Ease_linear.pde

ease_linear_method


Syntax

.linear(counter)

.linear(counter,option)

.linear(counter, start, stop)

.linear(counter, start, stop, option)

Parameters

counter (float) an incremental value between 0 and totalLength

start (float) the lowest desired output value

stop (float) the highest desired output value

option (String) either "loop", "alternate" or "once"

Return

float