/ Interface / Code Editor

Flexible Layouts . Integrated Docs
Menubar . Workspace Panel . Log Panel . Fibers Panel
Code Editor . Image Editor
SoundEditor . SoundPlayer . EnvelopeEditor
Plugin Explorer Dialog

---

home . Topics . Interface . Reference . Examples

---

code

Hz's Code Editor supports an integrated workflow for soundscape creation. You can edit multiple .js,, .hz, .md, .yaml (or any-old text files) in the same Hz session and easily jump between them. The Code Editor has syntax coloring for common file types and supports multiple key-bindings including VSCode and Vim. You can launch .js and .hz files directly from the Code Editor and preview .hz files in the same panel interactively.

The Basics

Open a file. Edit a File. Save a file.

Select. Copy. Paste.

Undo. Redo. Rinse. Repeat.

Special Features

Run It!

If you are editing a .js or .hz file, right clicking in the text area reveals the Run in Sandbox or Simple Hz Runner menu. You can edit, then Run it, listen to the results, then edit, then Run it ad infinitum.

Songs.hz Preview

If you are editing a .hz file, Cmd-or-Ctrl Shift P toggles an Songs.hz viewer where:

• you can preview the pianoroll associated with your .hz while typing it.
• the code cursor causes the associated preview note to highlight
• when the song is performed, the visualization updates with current note, so does the code editor cursors.

And here's what it looks like:

info   Use the mouse-wheel and mouse-drag to zoom and pan within your song. The context menu can be used to configure and reset controller settings. Also note that the code's context menu has an extended set of options.

Importantly, some .hz files can't be run directly via Simple Hz Runner. They must be launched from an associated .js file. For your convenience, Hz keeps track of recently launched .js files and offers the Rerun command.

More details on Songs.hz can be found here.

Customized Coding

At right you can see a veritable cornucopia of Code configuration options. You can raise this subpanel via hotkeys Cmd-or-Ctrl , or from the Code Menubar. Rather than delve into the details for all of these options, we refer you to the Ace website. Suffice it to say, where there's a programmer there are strong opinions about editor settings and we hope you can find your bliss from this collection.

Credits

Code Editor is built atop Ace.