Flute acoustics: measurement, modelling and design - School of ...

APPENDIX B. PROGRAM LISTINGS 307
Key key);
/*
Creates a new Hole.
Parameters:
radius: hole radius in m
length: segment length in m
boreRadius: the radius of the instrument bore at the position of
the hole
Returns:
a new Hole with the given parameters
*/
Key createKey(double radius, double holeRadius, double height,
double thickness, double wallThickness, double chimneyHeight);
/*
Creates a new Key.
Parameters:
radius: the radius of the key in m
holeradius: the radius of the hole in the key (for perforated
keys)
height: the regulation height of the open key
thickness: the thickness of the key
wallThickness: the thickness of the hole chimney
chimneyHeight: the height of the chimney above the bore
Returns:
a new Key with the given parameters
*/
EmbouchureHole createEmbouchureHole(double radiusin, double radiusout,
double length, double boreRadius);
/*
Creates a new EmbouchureHole.
Parameters:
radiusin: the radius at the bore
radiusout: the radius at the outside
length: the embouchure hole length
boreRadius: the radius of the instrument bore at the position of
the hole
Returns:
a new EmbouchureHole with the given parameters
*/
Head createHead(EmbouchureHole embouchureHole, Vector upstreamBore,
double upstreamFlange, Vector downstreamBore);
/*
Creates a new Head.
Parameters:
embouchureHole: the embouchure hole
upstreamBore: bore section between the embouchure hole and the
cork
upstream flange: the termination condition at the cork (default
-1)
downstreamBore: bore section between the embouchure hole and the
first tone hole
Returns:
a new Head with the given parameters
*/