| 
									
										
										
										
											2022-02-05 09:48:34 -05:00
										 |  |  | # AY-3-8910 instrument editor
 | 
					
						
							| 
									
										
										
										
											2022-02-04 16:05:25 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-09-10 13:16:55 -04:00
										 |  |  | the AY-3-8910 instrument editor consists of two tabs. | 
					
						
							| 
									
										
										
										
											2023-09-09 21:07:05 -04:00
										 |  |  | 
 | 
					
						
							|  |  |  | ## Sample
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | for sample settings, see [the Sample instrument editor](sample.md). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | the only differences are the lack of an "Use wavetable" option, and the presence of a "Use sample" one. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | note that using samples on AY is CPU expensive! | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Macros
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | - **Volume**: volume sequence. | 
					
						
							|  |  |  | - **Arpeggio**: pitch sequence. | 
					
						
							|  |  |  | - **Noise Freq**: noise generator frequency sequence. | 
					
						
							|  |  |  |   - note: global! | 
					
						
							|  |  |  | - **Waveform**: selector of sound type - square wave tone, noise and/or envelope generator. | 
					
						
							|  |  |  |   - you may select more than one option. | 
					
						
							|  |  |  | - **Pitch**: fine pitch. | 
					
						
							|  |  |  | - **Phase Reset**: trigger restart of **envelope**. | 
					
						
							|  |  |  | - **Envelope**: configures the hardware envelope. | 
					
						
							|  |  |  |   - **enable**: sets whether envelope is enabled. | 
					
						
							|  |  |  |   - **direction**: flips the envelope's direction. | 
					
						
							|  |  |  |   - **alternate**: when enabled, the envelope will change direction once it hits a boundary. | 
					
						
							|  |  |  |   - **hold**: sets whether the envelope should stop when hitting boundary, or loop. | 
					
						
							|  |  |  | - **AutoEnv Num**: sets the envelope to the channel's frequency multiplied by numerator. | 
					
						
							|  |  |  | - **AutoEnv Den**: sets the envelope to the channel's frequency multiplied by denominator. | 
					
						
							|  |  |  |   - these two must be set in order for AutoEnv to work! |