User's guide for excellut v1.0

Options

Options for excellut

Exporting options

  1. calc @ export (E1).
    Recalculate all exportable columns before exporting. All you have to do is fill in the basic LUT settings and the template cell and excellut will take it from there.
  2. make header (E2).
    This will create a header file (.h) to accompany the data file.
  3. define sizes (E3).
    If you enable this the header file will also contain defines for the LUT-sizes. Naturally, you'd have to have the make header option enabled too.
  4. Export button (G1).
    To export, press the big gray button named "Export". You know how to press a button, don't you? When you press it you'll be presented with a file-dialog. Name your file (with extension!) to export to here. The extension is important because that will determine the file-format. Current formats are C (.c), GNU assembly (.s) and Goldroad assembly (.asm).

Other options

  1. Calculate column (I2, J1).
    Each LUT has it's own column. If you have set the LUT up properly and filled in the template cell, this option will fill the rest of the LUT (extending the argument column too if necessary). Set the column index in I2 and press the button.

LUT settings

LUT settings

Of course, you don't get your LUTs entirely for free, Excellut still needs some information of what kind of LUT you want. The figure above shows the kinds of settings you have to account for.
Every column represents one LUT. The first two columns are reserved for description fields and the argument (x) column. If you mess with these, you might regret it.

  1. exportables (row 5).
    This row marks the LUTs that are actually exported. If a cell here is non-empty, then that LUT ends up in the exported file.
  2. bytes/num (row 6).
    This essentially incidates the data-type used for a LUT-value. Allowed are 1 for bytes, 2 for shorts, and 4 for ints.
  3. fixed point (row 7).
    All exproted numbers are fixed point numbers, so you'd better specify where the fixed point goes. Note that if the value is greater than the number of bits of the datatype, the LUT won't be exported. I mean, there'd be little point would there?
  4. name (row 8).
    Well the thing's gotta have a name, doesn't it? Note that the name must be a valid name for your language.
  5. size (row 9).
    This gives the number of LUT-elements. These are the number of array elements, not the number of bytes for the whole LUT. The "Column calc" and "calc @ export" functions both use this number, so it'd better be there.
  6. desc (row 10).
    An description of the LUT. This is an optional field with which you can tell the user of the LUT something about it. Like what formula was used to make it, which may be hard to see from just the numbers.
  7. template and data (row 11, ->).
    The "Column calc" and "calc @ export" options both use the formula from this row to create the rest of the data. This also marks the beginning of the LUT-data; if nothing else, this row must have a valid formula if you want the LUT exported.