Runs `abcm2ps` on .abc music files.
abc
.abc
.svg
.html
.xhtml
.eps
Setting | Description | Default |
---|---|---|
add-new-files | Boolean or list of extensions/patterns to match. | False |
added-in-version | Dexy version when this filter was first available. | |
additional-doc-filters | Filters to apply to additional documents created as side effects. | {} |
additional-doc-settings | Settings to apply to additional documents created as side effects. | {} |
args | Arguments to be passed to the executable. | |
check-return-code | Whether to look for nonzero return code. | True |
clargs | Arguments to be passed to the executable (same as 'args'). | |
command-string | The full command string. | %(prog)s %(args)s %(format)s -O %(output_file)s %(script_file)s |
data-type | Alias of custom data class to use to store filter output. | generic |
env | Dictionary of key-value pairs to be added to environment for runs. | {} |
examples | Templates which should be used as examples for this filter. | ['abc'] |
exclude-add-new-files | List of patterns to skip even if they match add-new-files. | [] |
exclude-new-files-from-dir | List of directories to skip when adding new files. | [] |
executable | The executable to be run | abcm2ps |
ext | File extension to output. | None |
ext-to-format | A dict of mappings from file extensions to format flags that need to be passed on the command line, e.g. for ragel with ruby host language .rb => -R | {'.eps': '-E', '.html': '-X', '.svg': '-g', '.svg1': '-v', '.xhtml': '-X'} |
extension-map | Dictionary mapping input extensions to default output extensions. | None |
help | Helpstring for plugin. | Runs `abcm2ps` on .abc music files. |
initial-timeout | 10 | |
input-extensions | List of extensions which this filter can accept as input. | ['.abc'] |
keep-originals | Whether, if additional-doc-filters are specified, the original unmodified docs should also be added. | False |
make-dummy-output | Whether to make a dummy output file when one is not generated and add-new-files is True. | False |
mkdir | A directory which should be created in working dir. | None |
mkdirs | A list of directories which should be created in working dir. | [] |
nodoc | Whether filter should be excluded from documentation. | False |
output | Whether to output results of this filter by default by reporters such as 'output' or 'website'. | True |
output-extensions | List of extensions which this filter can produce as output. | ['.svg', '.html', '.xhtml', '.eps'] |
override-workspace-exclude-filters | If True, document will be populated to other workspaces ignoring workspace-exclude-filters. | False |
path-extensions | strings to extend path with | [] |
preserve-prior-data-class | Whether output data class should be set to match the input data class. | False |
record-vars | Whether to add code that will automatically record values of variables. | False |
require-output | Should dexy raise an exception if no output is produced by this filter? | True |
scriptargs | Arguments to be passed to the executable. | |
tags | Tags which describe the filter. | ['music'] |
timeout | 10 | |
use-wd | Whether to use a custom working directory when running filter. | True |
variables | A dictionary of variable names and values to make available to this filter. | {} |
vars | A dictionary of variable names and values to make available to this filter. | {} |
version-command | Command to call to return version of installed software. | None |
windows-version-command | Command to call on windows to return version of installed software. | None |
workspace-exclude-filters | Filters whose output should be excluded from workspace. | ['pyg'] |
workspace-includes | If set to a list of filenames or extensions, only these will be populated to working dir. | None |
write-stderr-to-stdout | Should stderr be piped to stdout? | True |
ABC is a music notation which looks like this:
% Generated more or less automatically by swtoabc by Erich Rickheit KSC X:1 T:Jingle Bells M:4/4 L:1/4 K:C G/2G/2| G e d c| G3 G/2G/2| G e d c| A3 z/2 A/2| B f e d| B3 z/2 B/2|\ g g f d| e3 G/2G/2| G e d c| G3 G/2G/2| G e d c| A3 z/2 A/2| B f e d|\ g g g3/2 g/2| a g f d| c3 g| e e e2| e e e2| e g c3/2 d/2| e3 z| f f f3/2 f/2|\ f e e e/2e/2| e d d e| d2 g2| e e e2| e e e2| e g c3/2 d/2| e3 z|\ f f f3/2 f/2| f e e e/2e/2| g g f d| c3||
The abc filter converts this to one of the available output formats, using the abcm2ps utility which must be installed on your system. By default it will convert to SVG:
- jingle.abc|abc
Here is some of the SVG generated:
<?xml version="1.0" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"> <svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" color="black" width="701.60px" height="458.00px"> <style type="text/css"> .fill {fill: currentColor} .stroke {stroke: currentColor; fill: none}
To get EPS or another type of output, set the desired file extension:
- jingle.abc|abc|-: - abc: { 'ext' : '.eps' }
Here is some of the EPS generated:
%!PS-Adobe-2.0 EPSF-2.0 %%BoundingBox: 0 0 526 344 %%Title: jingle.abc (1) %%Creator: abcm2ps-8.14.2 %%CreationDate: Mar 31, 2020 22:11 %%LanguageLevel: 3 %%EndComments %CommandLine: -E -O jingle.eps jingle.abc save
You can also run the dexy eps2pdf filter to generate a PDF. In this case you don't need to specify any custom file extension because eps2pdf only accepts .eps files as inputs. In this example, we also set some custom command line arguments which get passed to abcm2ps:
- jingle.abc|abc|eps2pdf: - abc: { 'args' : '-s 2 -l' }
Here is the resulting PDF.
To generate HTML you can use the shortcut h filter which forces the previous filter to output HTML:
- jingle.abc|abc|h
The HTML output format wraps SVG output in a self-contained HTML page.
Content © 2020 Dr. Ana Nelson | Site Design © Copyright 2011 Andre Gagnon | All Rights Reserved.