/usr/include/genometools/annotationsketch/diagram_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 | /*
Copyright (c) 2007 Malte Mader <mader@zbh.uni-hamburg.de>
Copyright (c) 2007-2008 Sascha Steinbiss <steinbiss@zbh.uni-hamburg.de>
Copyright (c) 2007 Christin Schaerfer <schaerfer@zbh.uni-hamburg.de>
Copyright (c) 2007 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 DIAGRAM_API_H
#define DIAGRAM_API_H
/* The <GtDiagram> class acts as a representation of a sequence annotation
diagram independent of any output format. Besides annotation features as
annotation graphs, it can contain one or more custom tracks. A individual
graphical representation of the <GtDiagram> contents is created by creating a
<GtLayout> object using the <GtDiagram> and then calling
<gt_layout_sketch()> with an appropriate <GtCanvas> object. */
typedef struct GtDiagram GtDiagram;
#include "annotationsketch/custom_track_api.h"
#include "extended/feature_index_api.h"
#include "annotationsketch/style_api.h"
#include "annotationsketch/block_api.h"
#include "core/error_api.h"
/* A <GtTrackSelectorFunc> is a callback function which sets a <GtStr> to a
string to be used as a track identifier for assignment of a <GtBlock>
to a given track. */
typedef void (*GtTrackSelectorFunc)(GtBlock*, GtStr*, void*);
/* Create a new <GtDiagram> object representing the feature nodes in
<feature_index> in region <seqid> overlapping with <range>. The <GtStyle>
object <style> will be used to determine collapsing options during the
layout process. */
GtDiagram* gt_diagram_new(GtFeatureIndex *feature_index, const char *seqid,
const GtRange *range, GtStyle *style, GtError*);
/* Create a new <GtDiagram> object representing the feature nodes in
<features>. The features must overlap with <range>. The <GtStyle>
object <style> will be used to determine collapsing options during the
layout process.*/
GtDiagram* gt_diagram_new_from_array(GtArray *features, const GtRange *range,
GtStyle *style);
/* Returns the sequence position range represented by the <diagram>. */
GtRange gt_diagram_get_range(const GtDiagram *diagram);
/* Assigns a GtTrackSelectorFunc to use to assign blocks to tracks.
If none is set, or set to NULL, then track types are used as track keys
(default behavior). */
void gt_diagram_set_track_selector_func(GtDiagram*, GtTrackSelectorFunc,
void*);
/* Resets the track selection behavior of this <GtDiagram> back to the
default. */
void gt_diagram_reset_track_selector_func(GtDiagram *diagram);
/* Registers a new custom track in the diagram. */
void gt_diagram_add_custom_track(GtDiagram*, GtCustomTrack*);
/* Delete the <diagram> and all its components. */
void gt_diagram_delete(GtDiagram*);
#endif
|