/usr/include/genometools/annotationsketch/style_api.h is in libgenometools0-dev 1.5.1-2ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | /*
Copyright (c) 2007-2008 Sascha Steinbiss <steinbiss@zbh.uni-hamburg.de>
Copyright (c) 2008 Gordon Gremme <gremme@zbh.uni-hamburg.de>
Copyright (c) 2007-2008 Center for Bioinformatics, University of Hamburg
Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef STYLE_API_H
#define STYLE_API_H
#include <stdbool.h>
#include "annotationsketch/color_api.h"
#include "core/error_api.h"
#include "core/str_api.h"
#include "extended/genome_node_api.h"
typedef enum {
GT_STYLE_QUERY_OK,
GT_STYLE_QUERY_NOT_SET,
GT_STYLE_QUERY_ERROR
} GtStyleQueryStatus;
/* Objects of the <GtStyle> class hold __AnnotationSketch__ style information
like colors, margins, collapsing options, and others. The class provides
methods to set values of various types. Each value is organized into
a __section__ and is identified by a __key__. That is, a __section__, __key__
pair must uniquely identify a value. */
typedef struct GtStyle GtStyle;
/* Creates a new <GtStyle> object. */
GtStyle* gt_style_new(GtError*);
/* Increments the reference count of the given <GtStyle>. */
GtStyle* gt_style_ref(GtStyle*);
/* Enables unsafe mode (``io'' and ``os'' libraries loaded). */
void gt_style_unsafe_mode(GtStyle*);
/* Enables safe mode (``io'' and ``os'' libraries not accessible). */
void gt_style_safe_mode(GtStyle*);
/* Returns true if <sty> is in unsafe mode. */
bool gt_style_is_unsafe(GtStyle *sty);
/* Creates a independent (``deep'') copy of the given <GtStyle> object. */
GtStyle* gt_style_clone(const GtStyle*, GtError*);
/* Loads and executes Lua style file with given <filename>.
This file must define a global table called __style__. */
int gt_style_load_file(GtStyle*, const char *filename, GtError*);
/* Loads and executes Lua style code from the given <GtStr> <instr>.
This code must define a global table called __style__. */
int gt_style_load_str(GtStyle*, GtStr *instr, GtError*);
/* Generates Lua code which represents the given <GtStyle> object and
writes it into the <GtStr> object <outstr>.*/
int gt_style_to_str(const GtStyle*, GtStr *outstr, GtError*);
/* Reloads the Lua style file. */
void gt_style_reload(GtStyle*);
/* Sets a color value in the <GtStyle> for section <section> and <key> to a
certain <color>. */
void gt_style_set_color(GtStyle*, const char *section, const char *key,
const GtColor *color);
/* Retrieves a color value from <style> for key <key> in section <section>.
The color is written to the location pointed to by <result>. Optionally, a
feature node pointer <fn> can be specified for handling in node-specific
callbacks.
Because color definitions can be functions, <gt_style_get_color()> can fail
at runtime. In this case, this function returns GT_STYLE_QUERY_ERROR and
<err> is set accordingly.
If the color was not specified in <style>, a grey default color
is written to <result> and GT_STYLE_QUERY_NOT_SET is returned so the caller
can provide a custom default.
In case of successful retrieval of an existing color, GT_STYLE_QUERY_OK
is returned. */
GtStyleQueryStatus gt_style_get_color(const GtStyle *style, const char *section,
const char *key, GtColor *result,
GtFeatureNode *fn, GtError *err);
/* Set string with key <key> in <section> to <value>. */
void gt_style_set_str(GtStyle*, const char *section, const char *key,
GtStr *value);
/* Set numeric value of key <key> in <section> to <number>. */
void gt_style_set_num(GtStyle*, const char *section, const char *key,
double number);
/* Set boolean value of key <key> in <section> to <val>. */
void gt_style_set_bool(GtStyle*, const char *section, const char *key,
bool val);
/* Unset value of key <key> in <section>. */
void gt_style_unset(GtStyle*, const char *section, const char *key);
/* Deletes this <style>. */
void gt_style_delete(GtStyle *style);
#endif
|