1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115 |
x1
x1
x1
x1
x1
x1
x5
x1
x1
x1
x1
x1
x5
x5
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x1
x5
x337
x337
x338
x338
x337
x338
x338
x337
x338
x338
x1
x666
x337
x339
x339
x337
x339
x339
x337
x338
x338
x337
x338
x338
x337
x338
x338
x1
x659
x659
x337
x337
x1
x1
x5
x1
x1
x1
x1
x1
x1
x1
x1
x5
x15
x16
x16
x15
x24
x24
x1
x22
x1
x22
x22
x22
x22
x22
x22
x22
x22
x1
x22
x15
x1
x1
x5
x1
x1
x1
x1
x5
x16
x16
x16
x1
x16
x16
x16
x16
x16
x1
x16
x16
x5 |
|
/**
* @file Data structure for lanes_info packet
*
* @author aKuad
*/
import { typeof_detail } from "../util/typeof_detail.js";
/**
* Data structure for lanes_info packet
*/
export class LaneInfo {
/**
* Data structure of a lane
*
* @param {number} lane_id Lane ID
* @param {string} lane_name Lane name of view in mixer-client
* @param {number} current_gain_db Lane current gain (accept -80 ~ 80, under -80 will be adjusted to -80, it for accept -Infinity)
*
* @throws {TypeError} If `lane_id` is not `number`
* @throws {TypeError} If `lane_name` is not `string`
* @throws {TypeError} If `current_gain_db` is not `number`
* @throws {RangeError} If `lane_id` is not in 0~255
* @throws {RangeError} If `lane_name` is empty string
* @throws {RangeError} If `lane_name` has non ascii or ascii control characters
* @throws {RangeError} If `lane_name` has over 3 characters
* @throws {RangeError} If `current_gain_db` is over 80
*/
constructor(lane_id, lane_name, current_gain_db) {
// Arguments type checking
if (typeof lane_id !== "number") {
throw new TypeError(`lane_id must be number, but got ${typeof_detail(lane_id)}`);
}
if (typeof lane_name !== "string") {
throw new TypeError(`lane_name must be string, but got ${typeof_detail(lane_name)}`);
}
if (typeof current_gain_db !== "number") {
throw new TypeError(`current_gain_db must be number, but got ${typeof_detail(current_gain_db)}`);
}
// Arguments range checking
if (lane_id < 0 || lane_id > 255) {
throw new RangeError(`lane_id must be 0~255, but got ${lane_id}`);
}
if (!(/^[\x20-\x7F]*$/.test(lane_name))) {
throw new RangeError("For lane_name, non ascii characters are not allowed");
}
if (lane_name.length === 0) {
throw new RangeError("lane_name can't be empty string");
}
if (lane_name.length > 3) {
throw new RangeError(`For lane_name, over 3 characters string is not allowed, but got ${lane_name.length} characters`);
}
if (current_gain_db > 80) {
throw new RangeError(`current_gain_db must be under or equal 80, but got ${current_gain_db}`);
}
this.lane_id = lane_id;
this.lane_name = lane_name;
this.current_gain_db = current_gain_db < -80 ? -80 : current_gain_db; // under -80 adjust to -80
}
/**
* Instantiate `LaneInfo` from bytes
*
* @param {Uint8Array} bytes Lane info data in bytes
* @returns {LaneInfo} Data contained LanesInfo object
*
* @throws {TypeError} If `bytes` is not `Uint8Array`
* @throws {RangeError} If `bytes` length is not 5 (1 data should be 5 bytes)
*/
static from_bytes(bytes) {
if (!(bytes instanceof Uint8Array)) {
throw new TypeError(`bytes must be Uint8Array, but got ${typeof_detail(bytes)}`);
}
if (bytes.length != 5) {
throw new RangeError(`bytes must be 5, but got ${bytes.length}`);
}
const text_decoder = new TextDecoder();
const lane_id = bytes[0];
const lane_name_uint8t = bytes.slice(1, 4);
const lane_name = text_decoder.decode(lane_name_uint8t).trim();
const current_gain_db = (bytes[4] / 255 * 160) - 80; // scale conversion from 8bit to float [-80, 80]
// [0, 255]
// /255 -> [0, 1]
// *160 -> [0, 160]
// -80 -> [-80, 80]
return new LaneInfo(lane_id, lane_name, current_gain_db);
}
/**
* Export `LaneInfo` to bytes as a part of lane-info packet
*
* @returns {Uint8Array} Data struct in bytes as a part of lane-info packet
*/
to_bytes() {
const lane_name_adj3 = (this.lane_name + " ").slice(0, 3);
const text_encoder = new TextEncoder();
const lane_name_uint8t = text_encoder.encode(lane_name_adj3);
const current_gain_uint8t = (this.current_gain_db + 80) / 160 * 255; // scale conversion from float [-80, 80] to 8bit
// [-80, 80]
// +80 -> [0, 160]
// /160 -> [0, 1]
// *255 -> [0, 255]
return Uint8Array.of(this.lane_id, ...lane_name_uint8t, current_gain_uint8t);
}
}
|