Difference between revisions of "Standards and Conventions"

From Audacity Wiki
Jump to: navigation, search
(Right Click Behavior: {{todo}} moved to prefix position)
(Right Click Behavior: update)
Line 14: Line 14:
  
 
==Right Click Behavior==
 
==Right Click Behavior==
'''Reference:''' [https://docs.microsoft.com/en-us/windows/win32/uxguide/inter-mouse#standard-mouse-button-interactions Microsoft HIG].<br>
+
'''Reference:''' [https://docs.microsoft.com/en-us/windows/win32/uxguide/inter-mouse#standard-mouse-button-interactions Microsoft HIG].
 +
 
 +
Microsoft and Apple (and may others) have GUI design guidelines that specify that right-click gestures should normally be reserved for a context menu or null.
 +
 
 
'''Date Logged:''' 16Mar20
 
'''Date Logged:''' 16Mar20
  
 
'''Occurances of Non-Standard Behavior:'''
 
'''Occurances of Non-Standard Behavior:'''
# {{todo}} Right click drag to resize track height.
+
# {{todo}} Right click&drag to resize track height.
 +
# {{todo}} Right click&drag to resize relative channel sizes in a stereo track
 +
# {{todo}} Right click&drag to resize relative sizes in a Mult-view.
  
 
==Amplitude Scale and Gain==
 
==Amplitude Scale and Gain==

Revision as of 14:06, 17 March 2020

Audacity aims to follow recognized standards and conventions whenever applicable. This includes the choice of terminology (see: Wording), Human interface guidelines, format specifications, and platform specific conventions. For various reasons, Audacity sometimes diverges from accepted norms. This page is for tracking known issues where Audacity contravenes accepted standards.
New features or behaviors that conflict with established standards should NOT be logged here. They should be logged as bugs on Bugzilla, and ideally be fixed prior to release.
Warning icon Human Interface Guidelines

There are multiple "Human Interface Guidelines" (HIGs) for Desktop applications, and by and large they agree with each other:


Right Click Behavior

Reference: Microsoft HIG.

Microsoft and Apple (and may others) have GUI design guidelines that specify that right-click gestures should normally be reserved for a context menu or null.

Date Logged: 16Mar20

Occurances of Non-Standard Behavior:

  1. ToDo.png Right click&drag to resize track height.
  2. ToDo.png Right click&drag to resize relative channel sizes in a stereo track
  3. ToDo.png Right click&drag to resize relative sizes in a Mult-view.

Amplitude Scale and Gain

Reference: Standard practice in audio software is to use dBFS for amplitude, and dB for gain.
Date Logged: 16Mar20

Description: Audacity is inconsistent in it's representation of amplitude, sometimes using dBFS (like the rest of the audio world) and sometimes using a linear scale of +/- 1. It is particularly confusing that Audacity's shipped generators use a linear scale of 0 to 1, and Audacity's shipped effects use dB.

Occurances of Non-Standard Behavior:

  1. Track vertical ruler in "Waveform" view
  2. ToDo.png Chirp
  3. ToDo.png DTMF Tones
  4. ToDo.png Noise
  5. ToDo.png Risset Drum
  6. ToDo.png Tone