What is this?

It is including some of useful functions & it makes you can use sin, cos, tan, abs, power, floor... functions without "Math."

Some functions can be low performance than other JS libraries

That's because it is designed that it can be easily converted to other languages.

---

How to use?

At first, define below code and check the below functions

<script src = "https://cdn.jsdelivr.net/gh/ABER1047/Forme/scripts.js"></script>

Angles

point_direction(x1,y1,x2,y2)

---

This function returns the direction of a vector formed by the specified components [x1,y1] and [x2,y2]

point_direction2(x1,y1,x2,y2,x3,y3)

---

This function returns the direction(radian) of a vector formed by the specified components [x1,y1], [x2,y2], [x3,y3]

correct_deg(deg) / correct_rad(rad)

---

This function corrects degree value when it is over than 360 degree or negative degree into positive 0~360 degree

Example, 390 degree will be corrected to 30 degree.

rad(deg)

---

It converts degree to radian

deg(rad)

---

It converts radian to degree

Etc.

pi()

sin(rad) / asin(rad) / arcsin(rad) / asinh(rad)

cos(rad) / acos(rad) / arccos(rad) / acosh(rad)

tan(rad) / atan(rad) / arctan(rad) / atanh(rad) / atan2(rad)

---

functions which can be used without "Math."

It is more convenient to use with deg(rad) function or rad(deg) functions.

Distance/Collision/Geometry

point_distance(x1,y1,x2,y2)

---

This function returns the length of a vector formed by the specified components [x1,y1] and [x2,y2]

you can use this function when you want to get distance between two points

point_distance_3d(x1,y1,z1,x2,y2,z2)

---

This function takes the supplied components of the vector and returns the length (distance) of the vector.

It works in exactly the same way as point_distance() but with the addition of factoring in the z value (depth) for use in 3D space.

place_meeting_point(x1,y1,x2,y2,rad)

---

This function returns "true" when a point met or be inside a circle

place_meeting_circle(x1,y1,x2,y2,rad1,rad2)

---

This function returns "true" when two circles(collision mask) met

get_line_function(x1,y1,x2,y2)

---

This function returns inclination, y-intercept and function of line with two points of line.

The returned array have these values. array[0] = inclination of line array[1] = y-intercept array[2] = function of line

You can check these values with below code

Example

//it will show you "[4, 1, 'y=4x+1']".
console.log(get_line_function(0,1,1,5))

point_to_line_distance(x1,y1,x2,y2,x3,y3)

---

This function returns distance of point to line (The point do not have to have a position on only line).

x1,y1,x2,y2 parameter should be the value of points which make up the line.

And, x3,y3 should be the value of another point.

Example

//it will show you the value "3 x √2" which same as "4.242..."
console.log(point_to_line_distance(0,0,6,6,0,6))

Numerical/Random

irandom_range(range_1,range_2)

---

You supply the low value for the range as well as the high value, and the function will return a random integer value within (and including) the given range

For example, irandom_range(10, 35) will return an integer between 10 and 35 inclusive

irandom_return()

---

You can get -1 or 1 value by 50% chance

correct_value(value,min,max)

---

You can limit the value of range of numbers

Example

var a = 10

//limit the value of range
a = correct_value(a,0,5);

//it returns 5
console.log(a);
  

sign_without(value)

---

it functions same as "Math.sign(value)" but, when the value of sign was "0", it returns -1 or 1 by 50% chance

choose(val0, val1, val2, …, max_val)

---

it chooses the values from above parameters and returns it.

Example

//limit the value of range
var a = choose("A","B","C",1,2,3);

//it returns "A" or "B" or "C" or 1 or 2 or 3 by same chances
console.log(a);
  

factorial(n)

---

it returns mathematical factorial value

permutation(n,r)

---

it returns mathematical permutation value

combination(n,r)

---

it returns mathematical combination value

average(val0, val1, val2, …, max_val)

---

This function returns averaged value

arithmetic_seq(firstTerm,lastTerm,n)

---

This function returns sum of arithmetic sequence

It is useful when you want to get sum of repeated things

example, if you want to get the result of "1+3+5+7+ ... + 77"

geometric_seq(firstTerm,commonRatio,n)

---

This function returns sum of geometric sequence

inf_geometric_seq(firstTerm,commonRatio)

---

This function returns sum of infinite geometric sequence

highest_num(val0, val1, val2, …, max_val)

---

This function chooses highest number and returns it

highest_num_array(array)

---

This function chooses highest number from array and returns it

set_value_case(value, min, max, inner)

---

it returns another specific value by dividing the case where the value is within the range of the condition and the case where it is not.

Example

//setting
var value = 50;
var returns = 0;



returns = set_value_case(value, 0, 100, true);

//it returns 50 because the value "50" is between 0~100
console.log(returns);


returns = set_value_case(value, 100, 200, true);

//it returns 100 because the value "50" is smaller than "min" value [100]
console.log(returns);
  

Etc.

sign(rad) / abs(rad) / sqrt(rad) / pow(rad) / power(rad)

round(rad) / floor(rad)

---

functions which can be used without "Math."

Colors/Alpha

merge_color(color1, color2, amount, debug_mode)

---

you need to set the parameter "color1" and "color2" (hex color only) And then set the parameter "amount" to merge colors (0 is minimum and 1 is maximum. if amount value is less than 0 or over than 1, it is applied 0 and 1 if amount is 0, you can get only "color1" value, and if amount is 1, you can get only "color2" value)

Example

//it return "gray" color
merge_color("#ffffff", "#2a2a28", 0.5);

//if you want to see the result on console, use the parameter "debug mode"
merge_color("#ffffff", "#2a2a28", 0.5, 1);

Loading

preload_images(file_directory, type, image_name1, image_name2, image_name...)

---

it makes the images preloaded.

it is useful when you added new images after page loaded or change the already existed image to other one.

(if you didn't preload the images before this situations, the images are not shown until fully loaded)

Example

//it loads the images file "MY_GIF1.gif", "MY_GIF2.gif", "MY_GIF3.gif"
preload_images("my_pc/image_folder", "gif", "MY_GIF1", "MY_GIF2", "MY_GIF3");

//it loads the images file "MY_IMG1.png", "MY_IMG2.png", "MY_IMG3.png"
preload_images("my_pc/image_folder", "png", "MY_IMG1", "MY_IMG2", "MY_IMG3");
  

Time/Duration

get_remaining_time(audio)

---

you can get remaining audio/video time.

Example

var audio = document.getElementById("id_audio");

//it returns remaining time (seconds)
console.log(get_remaining_time(audio));
  

get_current_time(audio)

---

you can get current audio/video time

Example

var audio = document.getElementById("id_audio");

//it returns current time (seconds)
console.log(get_current_time(audio));
  

convert_sec_to_clocktime(seconds)

---

It converts seconds to clock time

Example

//it returns current clock time (1:00:00)
console.log(reconstruction_time_sec(3600)); //1 hour
  

convert_min_to_sec(minutes)

---

It converts minutes to seconds and returns it

Example

//it returns "60"
console.log(convert_min_to_sec(1)); //1 minute
  

convert_hour_to_min(hours)

---

It converts hours to minutes and returns it

Example

//it returns "60"
console.log(convert_hour_to_min(1)); //1 hour
  

convert_hour_to_sec(hours)

---

It converts hours to seconds and returns it

Example

//it returns "3600"
console.log(convert_hour_to_sec(1)); //1 hour
  

Sort/Arrange

arrange_value(val0, val1, val2, …, max_val)

---

This function returns arranged array

The parameters have to be consist of only "numbers".

Example

  
//it returns array [1,2,3,4,5,6]
console.log(arrange_value(6,2,5,3,4,1));
  

arrange_array(array)

---

This function returns arranged array

The perameter array have to be consist of only "numbers".

Example

var array_ = [6,2,5,3,4,1]
  
//it returns array [1,2,3,4,5,6]
console.log(arrange_array(array_));
  

arrange_text(text_array)

---

This function returns arranged array which is sorted alphabetically

Example

var array_ = ["B","A","C","가","나","가가","가나",];
  
//it returns array ["A", "B", "C", "가", "가가", "가나", "나"]
console.log(arrange_array(array_));