manpagez: man pages & more
html files: goffice
Home | html | info | man

GogAxis

GogAxis — An axis.

Synopsis

                    GogAxis;
enum                GogAxisSet;
enum                GogAxisType;
enum                GogAxisElemType;
GogAxisType         gog_axis_get_atype                  (GogAxis const *axis);
gboolean            gog_axis_is_center_on_ticks         (GogAxis const *axis);
gboolean            gog_axis_is_discrete                (GogAxis const *axis);
gboolean            gog_axis_is_inverted                (GogAxis const *axis);
gboolean            gog_axis_get_bounds                 (GogAxis const *axis,
                                                         double *minima,
                                                         double *maxima);
void                gog_axis_set_bounds                 (GogAxis *axis,
                                                         double minimum,
                                                         double maximum);
void                gog_axis_set_extents                (GogAxis *axis,
                                                         double start,
                                                         double stop);
GOFormat *          gog_axis_get_format                 (GogAxis const *axis);
gboolean            gog_axis_set_format                 (GogAxis *axis,
                                                         GOFormat *fmt);
unsigned            gog_axis_get_ticks                  (GogAxis *axis,
                                                         GogAxisTick **ticks);
GOData *            gog_axis_get_labels                 (GogAxis const *axis,
                                                         GogPlot **plot_that_labeled_axis);
double              gog_axis_get_entry                  (GogAxis const *axis,
                                                         GogAxisElemType i,
                                                         gboolean *user_defined);
void                gog_axis_add_contributor            (GogAxis *axis,
                                                         GogObject *contrib);
void                gog_axis_del_contributor            (GogAxis *axis,
                                                         GogObject *contrib);
GSList const *      gog_axis_contributors               (GogAxis *axis);
void                gog_axis_clear_contributors         (GogAxis *axis);
void                gog_axis_bound_changed              (GogAxis *axis,
                                                         GogObject *contrib);
GogGridLine *       gog_axis_get_grid_line              (GogAxis *axis,
                                                         gboolean major);
double              gog_axis_get_circular_rotation      (GogAxis *axis);
const GODateConventions * gog_axis_get_date_conv        (GogAxis const *axis);
GOFormat *          gog_axis_get_effective_format       (GogAxis const *axis);

enum                GogAxisPolarUnit;
double              gog_axis_get_polar_perimeter        (GogAxis *axis);
void                gog_axis_set_polar_unit             (GogAxis *axis,
                                                         GogAxisPolarUnit unit);
GogAxisPolarUnit    gog_axis_get_polar_unit             (GogAxis *axis);

Object Hierarchy

  GObject
   +----GogObject
         +----GogStyledObject
               +----GogAxisBase
                     +----GogAxis

Implemented Interfaces

GogAxis implements GOStyledObject and GogDataset.

Properties

  "assigned-format-string-XL" gchar*                : Read / Write
  "circular-rotation"        gdouble               : Read / Write
  "invert-axis"              gboolean              : Read / Write
  "map-name"                 gchar*                : Read / Write
  "polar-unit"               gchar*                : Read / Write
  "type"                     gint                  : Read / Write

Description

An axis of a GogPlot. The axis handles things like the bounds, ticks, and tick value formats. When used in plots with X/Y/Z axes, it can optionally have one GogLabel objects in the role "Label".

Details

GogAxis

typedef struct _GogAxis GogAxis;


enum GogAxisSet

typedef enum {
	GOG_AXIS_SET_UNKNOWN 	  = -1,
	GOG_AXIS_SET_NONE   	  = 0,
	GOG_AXIS_SET_X		  = (1 << GOG_AXIS_X),
	GOG_AXIS_SET_XY		  = (1 << GOG_AXIS_X) | (1 << GOG_AXIS_Y),
	GOG_AXIS_SET_XY_pseudo_3d = (1 << GOG_AXIS_X) | (1 << GOG_AXIS_Y) | (1 << GOG_AXIS_PSEUDO_3D),
	GOG_AXIS_SET_XY_COLOR 	  = (1 << GOG_AXIS_X) | (1 << GOG_AXIS_Y) | (1 << GOG_AXIS_COLOR),
	GOG_AXIS_SET_XY_BUBBLE 	  = (1 << GOG_AXIS_X) | (1 << GOG_AXIS_Y) | (1 << GOG_AXIS_BUBBLE),
	GOG_AXIS_SET_XYZ	  = (1 << GOG_AXIS_X) | (1 << GOG_AXIS_Y) | (1 << GOG_AXIS_Z),
	GOG_AXIS_SET_RADAR        = (1 << GOG_AXIS_CIRCULAR) | (1 << GOG_AXIS_RADIAL),
	GOG_AXIS_SET_FUNDAMENTAL  = ((1 << GOG_AXIS_VIRTUAL) - 1),
	GOG_AXIS_SET_ALL	  = ((1 << GOG_AXIS_TYPES) -1)
} GogAxisSet;


enum GogAxisType

typedef enum {
	GOG_AXIS_UNKNOWN = -1,
	GOG_AXIS_X	 = 0,
	GOG_AXIS_Y,
	GOG_AXIS_Z,
	GOG_AXIS_CIRCULAR,
	GOG_AXIS_RADIAL,
	GOG_AXIS_VIRTUAL,
	GOG_AXIS_PSEUDO_3D = GOG_AXIS_VIRTUAL,
	GOG_AXIS_COLOR,
	GOG_AXIS_BUBBLE,
	GOG_AXIS_TYPES
} GogAxisType;


enum GogAxisElemType

typedef enum {
	GOG_AXIS_ELEM_MIN = 0,
	GOG_AXIS_ELEM_MAX,
	GOG_AXIS_ELEM_MAJOR_TICK,
	GOG_AXIS_ELEM_MINOR_TICK,
	GOG_AXIS_ELEM_CROSS_POINT,
	GOG_AXIS_ELEM_MAX_ENTRY
} GogAxisElemType;


gog_axis_get_atype ()

GogAxisType         gog_axis_get_atype                  (GogAxis const *axis);

axis :

Returns :


gog_axis_is_center_on_ticks ()

gboolean            gog_axis_is_center_on_ticks         (GogAxis const *axis);

axis :

GogAxis

Returns :

TRUE if labels are centered on ticks when axis is discrete

gog_axis_is_discrete ()

gboolean            gog_axis_is_discrete                (GogAxis const *axis);

axis :

GogAxis

Returns :

TRUE if axis enumerates a set of discrete items, rather than a continuous value

gog_axis_is_inverted ()

gboolean            gog_axis_is_inverted                (GogAxis const *axis);

axis :

GogAxis

Returns :

TRUE if axis is inverted.

gog_axis_get_bounds ()

gboolean            gog_axis_get_bounds                 (GogAxis const *axis,
                                                         double *minima,
                                                         double *maxima);

axis :

GogAxis

minima :

non-NULL storage for result

maxima :

non-NULL storage for result

Returns :

TRUE if the bounds stored in minima and maxima are sane

gog_axis_set_bounds ()

void                gog_axis_set_bounds                 (GogAxis *axis,
                                                         double minimum,
                                                         double maximum);

Sets axis bounds. If minimum or maximum are not finite values, corresponding bound remains unchanged.

axis :

GogAxis

minimum :

axis low bound

maximum :

axis high bound

gog_axis_set_extents ()

void                gog_axis_set_extents                (GogAxis *axis,
                                                         double start,
                                                         double stop);

Set axis exents. It's a convenience function that sets axis bounds taking into account invert flag.

axis :

GogAxis

start :

axis start bound

stop :

axis stop bound

gog_axis_get_format ()

GOFormat *          gog_axis_get_format                 (GogAxis const *axis);

axis :

GogAxis

Returns :

the format assigned to axis but does not add a reference.

gog_axis_set_format ()

gboolean            gog_axis_set_format                 (GogAxis *axis,
                                                         GOFormat *fmt);

Absorbs a reference to fmt, and accepts NULL.

axis :

GogAxis

fmt :

GOFormat

Returns :

TRUE if things changed

gog_axis_get_ticks ()

unsigned            gog_axis_get_ticks                  (GogAxis *axis,
                                                         GogAxisTick **ticks);

An accessor to axis->ticks.

axis :

GogAxis

ticks :

an array of GogAxisTick

Returns :

number of ticks

gog_axis_get_labels ()

GOData *            gog_axis_get_labels                 (GogAxis const *axis,
                                                         GogPlot **plot_that_labeled_axis);

axis :

a GogAxis

plot_that_labeled_axis :

a GogPlot

Returns :

the possibly NULL GOData used as a label for this axis along with the plot that it was associated with

gog_axis_get_entry ()

double              gog_axis_get_entry                  (GogAxis const *axis,
                                                         GogAxisElemType i,
                                                         gboolean *user_defined);

axis :

GogAxis

user_defined :

an optionally NULL pointr to gboolean

Returns :

the value of axis element i and sets user_defined or NaN on error

gog_axis_add_contributor ()

void                gog_axis_add_contributor            (GogAxis *axis,
                                                         GogObject *contrib);

Register contrib as taking part in the negotiation of axis's bounds.

axis :

GogAxis

contrib :

GogObject (can we relax this to use an interface ?)

gog_axis_del_contributor ()

void                gog_axis_del_contributor            (GogAxis *axis,
                                                         GogObject *contrib);

contrib no longer takes part in the negotiation of axis's bounds.

axis :

GogAxis

contrib :

GogObject (can we relax this to use an interface ?)

gog_axis_contributors ()

GSList const *      gog_axis_contributors               (GogAxis *axis);

axis :

Returns :


gog_axis_clear_contributors ()

void                gog_axis_clear_contributors         (GogAxis *axis);

axis :


gog_axis_bound_changed ()

void                gog_axis_bound_changed              (GogAxis *axis,
                                                         GogObject *contrib);

axis :

GogAxis

contrib :

GogObject

gog_axis_get_grid_line ()

GogGridLine *       gog_axis_get_grid_line              (GogAxis *axis,
                                                         gboolean major);

axis :

major :

Returns :


gog_axis_get_circular_rotation ()

double              gog_axis_get_circular_rotation      (GogAxis *axis);

axis :

a GogAxis

Returns :

rotation of a circular GogAxis.

gog_axis_get_date_conv ()

const GODateConventions * gog_axis_get_date_conv        (GogAxis const *axis);

axis :

Returns :


gog_axis_get_effective_format ()

GOFormat *          gog_axis_get_effective_format       (GogAxis const *axis);

axis :

Returns :


enum GogAxisPolarUnit

typedef enum {
	GOG_AXIS_POLAR_UNIT_DEGREES,
	GOG_AXIS_POLAR_UNIT_RADIANS,
	GOG_AXIS_POLAR_UNIT_GRADS,
	GOG_AXIS_POLAR_UNIT_MAX
} GogAxisPolarUnit;


gog_axis_get_polar_perimeter ()

double              gog_axis_get_polar_perimeter        (GogAxis *axis);

axis :

Returns :


gog_axis_set_polar_unit ()

void                gog_axis_set_polar_unit             (GogAxis *axis,
                                                         GogAxisPolarUnit unit);

Sets unit of a circular axis. See GogAxisPolarUnit for valid values.

axis :

a GogAxis

unit :

GogAxisPolarUnit

gog_axis_get_polar_unit ()

GogAxisPolarUnit    gog_axis_get_polar_unit             (GogAxis *axis);

axis :

a GogAxis

Returns :

unit of axis if it's a circular axis of a polar axis set, -1 otherwise.

Property Details

The "assigned-format-string-XL" property

  "assigned-format-string-XL" gchar*                : Read / Write

The user assigned format to use for non-discrete axis labels (XL format).

Default value: "General"


The "circular-rotation" property

  "circular-rotation"        gdouble               : Read / Write

Rotation of circular axis.

Allowed values: [-180,180]

Default value: 0


The "invert-axis" property

  "invert-axis"              gboolean              : Read / Write

Scale from high to low rather than low to high.

Default value: FALSE


The "map-name" property

  "map-name"                 gchar*                : Read / Write

The name of the map for scaling.

Default value: "linear"


The "polar-unit" property

  "polar-unit"               gchar*                : Read / Write

Polar axis set unit.

Default value: "Degrees"


The "type" property

  "type"                     gint                  : Read / Write

Numerical type of this axis.

Allowed values: [-1,8]

Default value: -1

© manpagez.com 2000-2017
Individual documents may contain additional copyright information.