Fixup round for doxygen

This commit is contained in:
Mario Hüttel 2019-09-28 22:57:31 +02:00
parent e703d4427a
commit 7cbde0f30a
11 changed files with 41 additions and 37 deletions

View File

@ -2,7 +2,7 @@
* @defgroup ExternalRenderer External Shared Object Renderer * @defgroup ExternalRenderer External Shared Object Renderer
* @ingroup GdsOutputRenderer * @ingroup GdsOutputRenderer
* *
* @subsection ExternalRendererProps Properties * @section ExternalRendererProps Properties
* This class inherits all properties from its parent @ref GdsOutputRenderer. * This class inherits all properties from its parent @ref GdsOutputRenderer.
* In addition to that, it implements the following properties: * In addition to that, it implements the following properties:
* *

View File

@ -15,7 +15,7 @@
* *
* By default this class implements the following features: * By default this class implements the following features:
* *
* @subsection GdsOutputRendererProps Properties * @section GdsOutputRendererProps Properties
* Property Name | Description * Property Name | Description
* -----------------|---------------------------------------------------------------- * -----------------|----------------------------------------------------------------
* layer-settings | LayerSettings object containing the layer rendering information * layer-settings | LayerSettings object containing the layer rendering information
@ -23,7 +23,7 @@
* *
* All these properties have to be set for rendering. * All these properties have to be set for rendering.
* *
* @subsection GdsOutputRendererSignals Signals / Events * @section GdsOutputRendererSignals Signals / Events
* Signal Name | Description | Callback prototype * Signal Name | Description | Callback prototype
* -----------------|-------------------------------------------------|----------------------------------------------------------- * -----------------|-------------------------------------------------|-----------------------------------------------------------
* async-finished | The asynchronous rendering is finished | void callback(GdsOutputRenderer *src, gpointer user_data) * async-finished | The asynchronous rendering is finished | void callback(GdsOutputRenderer *src, gpointer user_data)

View File

@ -4,7 +4,7 @@
* *
* This is the class implementing the \f$\mbox{\LaTeX}\f$ / TikZ output rendering * This is the class implementing the \f$\mbox{\LaTeX}\f$ / TikZ output rendering
* @subsection LaTeXRendererProps Properties * @section LaTeXRendererProps Properties
* This class inherits all properties from its parent @ref GdsOutputRenderer. * This class inherits all properties from its parent @ref GdsOutputRenderer.
* In addition to that, it implements the following properties: * In addition to that, it implements the following properties:
* *

View File

@ -4,24 +4,24 @@
To use the application on the command line check 'gds-render `--`help'. To use the application on the command line check 'gds-render `--`help'.
Usage: Usage:
gds-render [OPTION…] FILE - Convert GDS file <FILE> to graphic gds-render [OPTION…] FILE - Convert GDS file `<FILE>` to graphic
Help Options: Help Options:
-h, '--'help Show help options -h, `--`help Show help options
'--'help-all Show all help options `--`help-all Show all help options
'--'help-gtk Show GTK+ Options `--`help-gtk Show GTK+ Options
Application Options: Application Options:
-v, '--'version Print version -v, `--`version Print version
-r, '--'renderer=pdf|svg|tikz|ext Renderer to use -r, `--`renderer=pdf|svg|tikz|ext Renderer to use
-s, '--'scale=<SCALE> Divide output coordinates by <SCALE> -s, `--`scale=`<SCALE>` Divide output coordinates by `<SCALE>`
-o, '--'output-file=PATH Output file path -o, `--`output-file=PATH Output file path
-m, '--'mapping=PATH Path for Layer Mapping File -m, `--`mapping=PATH Path for Layer Mapping File
-c, '--'cell=NAME Cell to render -c, `--`cell=NAME Cell to render
-a, '--'tex-standalone Create standalone PDF -a, `--`tex-standalone Create standalone PDF
-l, '--'tex-layers Create PDF Layers (OCG) -l, `--`tex-layers Create PDF Layers (OCG)
-P, '--'custom-render-lib=PATH Path to a custom shared object, that implements the render_cell_to_file function -P, `--`custom-render-lib=PATH Path to a custom shared object, that implements the render_cell_to_file function
'--'display=DISPLAY X display to use `--`display=DISPLAY X display to use
@section gui Graphical User Interface @section gui Graphical User Interface
@ -33,7 +33,7 @@ It is possible to export the layer configurations so they can be used later on.
@image html gui.png @image html gui.png
@image latex gui.png @image latex gui.png
The cell selector on the left shows the GDS Libraries and Cells. The cells are marked green if all references inside the cell could be found. If not all references could be found, the cell is marked orange. This doens't show if child cells have missing childs. Only one level of the hierarchy is checked in order to make it easier to spot an errorneous cell. Cells with missing child cells are still renderable but '--' obviously '--' faulty. If a cell or any sub-cell contains a reference loop, the cell is marked red. In this case it can't be selected for rendering. The cell selector on the left shows the GDS Libraries and Cells. The cells are marked green if all references inside the cell could be found. If not all references could be found, the cell is marked orange. This doens't show if child cells have missing childs. Only one level of the hierarchy is checked in order to make it easier to spot an errorneous cell. Cells with missing child cells are still renderable but `--` obviously `--` faulty. If a cell or any sub-cell contains a reference loop, the cell is marked red. In this case it can't be selected for rendering.
In the above image the cell is green; so everything is okay. In the above image the cell is green; so everything is okay.

View File

@ -42,16 +42,16 @@
* @param layer_file Layer mapping file * @param layer_file Layer mapping file
* @param so_path Shared object * @param so_path Shared object
* @param tex_standalone Standalone TeX * @param tex_standalone Standalone TeX
* @param tec_layers TeX OCR layers * @param tex_layers TeX OCR layers
* @param scale Scale value * @param scale Scale value
* @return Error code, 0 if successful * @return Error code, 0 if successful
*/ */
int command_line_convert_gds(const char *gds_name, int command_line_convert_gds(const char *gds_name,
const char *cell_name, const char *cell_name,
char **renderers, char **renderers,
char **output_file_names, char **output_file_names,
const char *layer_file, const char *layer_file,
const char *so_path, const char *so_path,
gboolean tex_standalone, gboolean tex_standalone,
gboolean tex_layers, gboolean tex_layers,
double scale); double scale);

View File

@ -18,8 +18,8 @@
*/ */
/** /**
* @file layer-info.h * @file layer-settings.h
* @brief LayerSettings class heade file * @brief LayerSettings class header file
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */
@ -96,8 +96,12 @@ int layer_settings_remove_layer(LayerSettings *settings, int layer);
GList *layer_settings_get_layer_info_list(LayerSettings *settings); GList *layer_settings_get_layer_info_list(LayerSettings *settings);
/** /**
* @brief Write layer settings to a CSV file * @brief Write layer settings to a CSV file.
* @param path *
* This function writes the layer settings to a CSV file according to the
* layer mapping specification (@ref lmf-spec)
* @param settings LayerSettings object
* @param path Output path for CSV file.
* @return 0 if successful * @return 0 if successful
*/ */
int layer_settings_to_csv(LayerSettings *settings, const char *path); int layer_settings_to_csv(LayerSettings *settings, const char *path);

View File

@ -17,7 +17,7 @@
* along with GDSII-Converter. If not, see <http://www.gnu.org/licenses/>. * along with GDSII-Converter. If not, see <http://www.gnu.org/licenses/>.
*/ */
/** /**
* @file cairo-output.h * @file cairo-renderer.h
* @brief Header File for Cairo output renderer * @brief Header File for Cairo output renderer
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */

View File

@ -18,7 +18,7 @@
*/ */
/** /**
* @file latex-output.h * @file latex-renderer.h
* @brief LaTeX output renderer * @brief LaTeX output renderer
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */

View File

@ -18,7 +18,7 @@
*/ */
/** /**
* @file layer-info.c * @file layer-settings.c
* @brief Implementation of the LayerSettings class * @brief Implementation of the LayerSettings class
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */

View File

@ -17,7 +17,7 @@
* along with GDSII-Converter. If not, see <http://www.gnu.org/licenses/>. * along with GDSII-Converter. If not, see <http://www.gnu.org/licenses/>.
*/ */
/** /**
* @file cairo-output.c * @file cairo-renderer.c
* @brief Output renderer for Cairo PDF export * @brief Output renderer for Cairo PDF export
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */

View File

@ -18,7 +18,7 @@
*/ */
/** /**
* @file latex-output.c * @file latex-renderer.c
* @brief LaTeX Output Renderer * @brief LaTeX Output Renderer
* @author Mario Hüttel <mario.huettel@gmx.net> * @author Mario Hüttel <mario.huettel@gmx.net>
*/ */