__init__

Constructor of MusicStaves. This base constructor should be called by all derived classes.

Signature:

__init__(image, staffline_height=0, staffspace_height=0)

with

image:

Onebit or greyscale image of which the staves are to be removed. MusicStaves creates a copy of the given image, so that the original image is not altered. The staff line removal will be done on MusicStaves.image

staffline_height:

average height of a single black staff line. When zero is given, MusicStaves computes it itself (recommended, unless you know exactly what you are doing).

staffspace_height:

average distance between adjacent lines of the same staff. When zero is given, MusicStaves computes it itself (recommended, unless you know exactly what you are doing).

remove_staves

Detects and removes staff lines from a music/tablature image.

This method is virtual and must be implemented in every derived class. Each implementation must at least support the following keyword arguments:

crossing_symbols:

Determines which symbols crossing staff lines the removal should try to keep intact. Possible values are 'all', 'bars' (only keeps long vertical lines uncut) or 'none' (does not care about crossing smyblos).

num_lines:

Number of lines within one staff. In general it can be hard to guess this number automatically; if the staff removal algorithm supports this, a value num_lines=0 can be used to indicate that this number should be guessed automatically.

Additional algorithm specific keyword are possible of course. If crossing_symbols cannot be chosen in the algorithm, this option must be offered nevertheless (albeit with no effect).

get_staffpos

Returns the y-positions of all staff lines at a given x-position. Can only be called after remove_staves.

This method is virtual and must be implemented in every derived class. Each implementation must have the following signature:

get_staffpos(x=0)

with

x:

x-position at which the staffpositions are computed. For x=0, the average y-positions over the full staffwidth is returned. A value differnt from zero only makes sense, when the staff removal algorithm supports skewed or otherwise deformed staff lines. For most algorithms the value of x will have no effect on the output.

The return value is a list of StaffObj.

blabla