Testing/faq.html at main · Un-conventional/Testing · GitHub

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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="icon" type="image/x-icon" href="./favicon.ico" />
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
	<meta name="theme-color" content="#CCCCCC"/>
	<meta property="og:image" content="/icon_maskable_192.png" />
	<meta name="description" content="Unbox is a mod of UltraBox." />
    <title>Unbox FAQ</title>
    <style type="text/css">

        html {
            background: var(--page-margin, black);
            overflow-x: hidden;
            font-size: large;
            font-family: 'B612', sans-serif;
            line-height: 1.3;
            color: var(--primary-text, white);
        }

        body {
            margin-left: 3vw;
            margin-right: 3vw;
        }

       h1 {
            font-size: 1.7rem;
            text-align: center;
			align-items: center;
            align-content: center;
            margin-top: 0.5em;
            margin-bottom: 0.5em;
            -webkit-text-stroke-width: 0;
        }

        h2, summary {
            font-size: 1.5rem;
			font-weight: bold;
            margin-top: 0.5em;
            margin-bottom: 0.5em;
            -webkit-text-stroke-width: 0;
        }


        h3 {
            font-size: 1.2rem;
            margin-top: 0.5em;
            margin-bottom: 0.5em;
            -webkit-text-stroke-width: 0;
        }

        a {
            color: var(--link-accent, #FFD700);
        }
    </style>
  </body>


<h1>
<font color="#7bc7cbB">Frequently Asked Questions</font>
</h1>

<!-- description of unbox here? -->

<summary><font color="#FFD700">Read first!</font></summary>
What is Unbox? (See below)
    <li>This is <font color="#9c64f7">UltraBox</font> but with my ideas added on. This also is sort of a testing ground for me to learn code.</li>
    <li>Some ideas come from how sound chips work and that and many ideas may seem excessive but pushing limits is fun.</li>
    <li>This mod is for anyone regardless of skill level, I strongly suggest checking out <a href=https://ultraabox.github.io>UltraBox</a> first though.</li>
    <li>Why does it exist? - It exists because I wanted it to exist. I got tired of asking "what if X existed" or "why can't W, X, Y apply to Z as well".</li>
    <li>Why is the b in <font color="#FFD700">Unbox</font> not a capitalized B? Why is it not called <font color="#a1afb0">UnBox</font> or <font color="#a1afb0">UNBox</font>? Because I said so and I found it weird having it spelled that way.</li>

    <details>
        <summary>How does Unbox differ from UltraBox?</summary>
            The current features include:<br><br>

            <h3>± 24 Pitch Shift Range</h3>
                <ul><li>I felt the range was too small so I increased it. It still works the same as normal Pitch Shift but with more range.</li></ul>

            <h3>0%-100% Pulse Width Range</h3>
                <ul><li>The fact that 1%-50% just felt limiting. With what I added, 0-100% is possible if you include the decimal offset. There is just so much that is possible with that range increase</li></ul>

            <h3>Several new chip waves and presets</h3>
                <ul><li>The new "chip" chipwaves/presets mimic what exists on chips - These are a work in progress! Feedback is requested to make these better.</li></ul>
                <ul><li>The new Presets that arent chip mostly consist of instruments I like and a few have sentimental value. These are also work in progress!</li></ul>

            <h3>Increased max tempo to 1000</h3>
                <ul><li>Ever wanted to make songs that are faster than 500 "tempo"? For "Pseudo Overclock" that would limit you to about 200Hz. I increased it to 1000 so 400Hz "Pseudo Overclock" should be available. I would like to increase it to 10k at one point for 1kHz.</li></ul>
                <ul><li>I also added new rhythms that should help out if you increase the beats per bar in tandem with higher tempo. You still can edit the tempo via the text box regardless.</li></ul>

            <h3>Set playerhead to start of loop</h3>
                <ul><li>How many times did you want to jump to the start of the loop? All the time? Yeah, that is why I made this shortcut. It even was put in <font color="#9c64f7">UltraBox</font>!</li></ul>

            <h3>Three new themes, Classic and Legacy and Glow.</h3>
                <ul><li>Classic is the default theme, I think its nice.</li></ul>
                <ul><li>Legacy is the original theme but it has issues but I still like it.</li></ul>
                <ul><li>Glow is something I wanted to try with transparent stuff. I like it.</li> </ul>

            <h3>What happened to Duty Cycle?</h3>
                <ul><li>This has been replaced with a Sequence/Macro system.</li></ul>
                <ul><li>This new system won't be limited to just Duty Cycle</li></ul>
                <ul><li>I wanted to revive a function from an old mod called <font color="#FFCA00">SandBox</font> and that mod had Duty Cycle but it was limited to a few pulse widths and only 2 cycle types.</li></ul>
                <ul><li>However, this system will improve it and allow other functions as stated below.</li></ul>

            <h3>Sequence Editor</h3>
                <ul><li>This replaced "Duty Cycle" and improved upon the original idea I had for it.</li></ul>
                <ul><li>It has a layout similar to trackers so if you know trackers, you probably know how to use this.</li></ul>

        </details>

        <details>
            <summary>What features are planned?</summary>
            I cannot guarantee anything but what is likely to be added are as follows.

                <h3>Macro/Sequence</h3>
                    <ul><li>Most values should be able to be automated using this system. Each sequence i unique and can be shared.</li></ul>

                <h3>Ring Modulation (AB)</h3>
                    <ul><li>Porting from AbyssBox. Intention for it to work with Macro/Sequence.</li></ul>

                <h3>Oscillator Sync</h3>
                    <ul><li>This is a way to make "Hard Sync". Intention for it to work with Macro/Sequence.</li></ul>
     <!---
                <h3>Timer Envelopes? (WIP Name)</h3>
                    <ul><li>Timer is a fancy "Custom Chip" that can be made by envelopes styled from the YM2149F and linear values. Intention for it to work with Macro/Sequence and "Hard Sync" for "SyncBuzzer".</li></ul>

                <h3>Timer Effects - Another YM2149F feature</h3>
                    <ul><li>ST "SID Voice" (Inverted square Phasing)</li></ul>
                    <ul><li>"Sid Voice" 2 Freq</li></ul>
                    <ul><li>MAC_SEQ compat.</li></ul>

                <h3>Groove Pattern</h3>
                    <ul><li>Set a groove without messing with the tempo in a modulator channel!</li></ul>

                <h3>Phase Reset</h3>
                    <ul><li>Retrigger the phase of the waveform, intention for it to work with Macro/Sequence.</li></ul>

                <h3></h3>
                    <ul><li></li></ul>
            --->
        </details>

        <details>
            <summary>How do I add custom samples?</summary>
            Since Unbox doesn't have a web server of its own, you'll have to first upload your sample to a CORS-friendly website.
            <ul><li>The easiest to use is <a href="https://filegarden.com/">File Garden</a>.</li></ul>

            Next, you have to copy the URL of the sound itself. The URL should end with the filetype, such as <code>.wav</code> or <code>.mp3</code>.
            <br><br>

            To import it into Unbox, open the Edit tab, scroll to the bottom, and click on "Add Custom Samples..."
            <br><br>

            Paste your url and press "Okay." If everything goes smoothly, Unbox will reload and your sample will be available in the preset list.
            </details>

            <!-- <details>
            <summary>How do I add samples to UB Offline?</summary>
            stuff
            </details> -->

            <!-- <details> -->
            <!-- <summary>What are the original sources of the built-in samples? Can I use them without legal repercussions?</summary> -->
            <!-- stuff -->
            <!-- huge list of all the legacysample origins here -->
            <!-- </details> -->

            <details>
            <summary>Does Unbox have an offline version?</summary>
            NO!, Not yet but you can access UltraBox's <a href="https://github.com/ultraabox/ultrabox_typescript/releases">here</a>.<br>
            You can either download an OS-specific version that has custom sampling support, or the generic HTML version that lacks custom sampling support.
            </details>

            <details>
            <summary>Does Unbox claim ownership over songs created with it?</summary>
            Unbox does not claim ownership over songs created with it, so original songs belong to their authors.<br><br>
            Neither Unbox nor its creator assume responsibility for any copyrighted material played on Unbox. No songs are ever received, recorded, or distributed by Unbox's servers. All song data is contained in the URL after the hash (#) mark, and Unbox running inside your browser converts that data into sound waves.
            </details>

            <!-- <details>
            <summary>Can I modify UltraBox?</summary>
            Yes! You can download and use <a href="https://github.com/ultraabox/ultrabox_typescript" target="_blank">the source code</a> under the MIT license.<br>
            The original BeepBox source code by John Nesky can be found <a href="https://github.com/johnnesky/beepbox" target="_blank">here.
            </details> -->

            <details>
            <summary>When will <code>x</code> feature be added?</summary>
            You can track the progress of new features on the <a href="https://github.com/Un-conventional/Unbox_typescript/issues">issues page or look at the Unbox forum in the Modding Server.</a>.<br>
            Please be patient; I work on Unbox in with my free time. I can't guarantee that anything will be out in a timely manner. (I may delay it out of spite if you push >:} )
            </details>

            <details>
            <summary>Where can I contact the developer?</summary>
            You can contact the me via the <a href="https://discord.gg/Tc997TstJb">BeepBox Modding server</a>.<br>
            You can also contact me on the <a href="https://github.com/Un-conventional/Unbox_typescript/issues">issues page</a> if you have ideas/suggestions or have encountered any bugs.
            </details>


<h1><font color="#FFCA00">Guide for Unbox below</font></h1>

<details>
<h1></h1>
<summary>Index</summary>
    This index should give information on various aspects of this mod. Listed below are the aspects to be looked at.<br><br>
   <!---<Presets
        Chipwaves
        Sequence Editor
        Things and such
   --->
    <details>
        <summary>Presets</summary>
            That's quite a bit of presets!<ul>If you are the owner of an instrument, let me know and ill give you credit (or have it removed), I probably missed or didn't remember so remind me!</ul><br><br>
            <H3>Sound Chip presets</H3>
                <ul><li>These are intended to be close to the sounds produced from the chip. It isn't perfect. For example, "ZX/ST" Presets are for the AY-3-8910 based soundchips (including the YM2149f) and the "NES" Presets are for anything related to 2a03, VRC6, and MMC5 granted the expansion is unique to it unlike the 5B that uses a half-clocked YM2149f in this case.</li></ul>
            <h3>General presets</h3>
                <ul><li>These are instruments I like and often use, I avoided putting "Presets" in the name to mark the distinction from the existing presets. </li></ul>
            <h3>Challenge presets?</h3>
                <ul><li>These are presets from Weekly Challenges that I like. (you can find Weekly Challenge and more at the Beepbox Discord)</li></ul>
            <h3>Old/Legacy presets?</h3>
                <ul><li>Old presets I still say have some use</li></ul>
    </details>

    <details>
        <summary>Chipwaves</summary>
            <h3>VRC6 Sawtooth?</h3>
                <ul><li>This is a new more accurate one and includes the "HI" varaint.</li></ul>
            <h3>Buzzer?</h3>
                <ul><li>Logarithmic Triangle and Sawtooth waves with a distinct sound most notably from the AY-3 and YM2149 sound chips. Obelisco is the Furnace name for this and the old variant of this has this name.</li></ul>
            <h3>ST TImer?</h3>
                <ul><li>This mimics A timer Effect often used on the Atari ST (YM 2149f based system).</li></ul>
                <ul>The AY/YM waveform that is more "fine" with 32 points in its period is the "Hardware Envelope" found on the 2149f and the 8930. The "Timer" Is the Buzzer Waveform made from volume values via "Interrupt". The Standard AY Waveform is what is produced by the 8910/12/14</ul>
            <h3>C64? Waveforms - SID 6581 and 8580</h3>
                <ul>Don't ask for the Revision number and keep in mind, IRL two "identical" SID chips may sound drastically different from each other, even with the same revision.</ul>
                    <ul><li>Sawtooth - 6581 Styled (for 8580, use FM Sawtooth if you don't like the chipwave)</li></ul>
                    <ul><li>Triangle - 6581 Styled (for 8580, use FM Triangle if you don't like the chipwave)</li></ul>
                    <ul><li>Tripulse - 6581 and 8580 style</li></ul>
                    <ul><li>Sawpulse - 6581 and 8580 style</li></ul>
                    <ul><li>Trisaw - 6581 and 8580 style</li></ul>
                    <ul><li>Trisawpulse - 6581 and 8580 style</li></ul>
                <h3>Hand saw? (what?)</h3>
                <ul><li>Waveforms based off of sawteeth because I can.</li></ul>
            <h3>Wavetable?</h3>
                <ul><li>Just "Custom Chip" waveforms </li></ul>
    </details>
<!--
    <details>
        <summary>Sequence Editor</summary>
            <h3>What is it?</h3>
                <ul><li></li></ul>

    </details>--->

</details>

<h1>More to come in the future!</h1>

</body>
</html>