![]() |
![]() |
![]() |
GOffice Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
GogAxisMap; double gog_axis_map (GogAxisMap *map
,double value
); double gog_axis_map_derivative_to_view (GogAxisMap *map
,double value
); gboolean gog_axis_map_finite (GogAxisMap *map
,double value
); void gog_axis_map_free (GogAxisMap *map
); double gog_axis_map_from_view (GogAxisMap *map
,double value
); double gog_axis_map_get_baseline (GogAxisMap *map
); void gog_axis_map_get_bounds (GogAxisMap *map
,double *minimum
,double *maximum
); void gog_axis_map_get_extents (GogAxisMap *map
,double *start
,double *stop
); void gog_axis_map_get_real_bounds (GogAxisMap *map
,double *minimum
,double *maximum
); void gog_axis_map_get_real_extents (GogAxisMap *map
,double *start
,double *stop
); gboolean gog_axis_map_is_discrete (GogAxisMap *map
); gboolean gog_axis_map_is_inverted (GogAxisMap *map
); gboolean gog_axis_map_is_valid (GogAxisMap *map
); GogAxisMap* gog_axis_map_new (GogAxis *axis
,double offset
,double length
); double gog_axis_map_to_view (GogAxisMap *map
,double value
);
double gog_axis_map (GogAxisMap *map
,double value
);
Converts value
to plot coordinates. A value in [0,1.0] range means a data
within axis bounds.
|
a GogAxisMap |
|
value to map to plot space. |
Returns : |
mapped value. |
double gog_axis_map_derivative_to_view (GogAxisMap *map
,double value
);
|
a GogAxisMap |
|
value to map to canvas space |
Returns : |
the derivative of the mapping expression at value. |
gboolean gog_axis_map_finite (GogAxisMap *map
,double value
);
Tests whether value
is valid for the given map
.
|
a GogAxisMap |
|
value to test |
Returns : |
TRUE if value means something
|
void gog_axis_map_free (GogAxisMap *map
);
Frees GogAxisMap object.
|
a GogAxisMap |
double gog_axis_map_from_view (GogAxisMap *map
,double value
);
Converts value from canvas space to data space.
|
a GogAxisMap |
|
value to unmap from canvas space. |
Returns : |
value in data coordinates |
double gog_axis_map_get_baseline (GogAxisMap *map
);
|
a GogAxisMap |
Returns : |
the baseline for map , in view coordinates,
clipped to offset and offset+length, where offset and length
are the parameters of gog_axis_map_new.
|
void gog_axis_map_get_bounds (GogAxisMap *map
,double *minimum
,double *maximum
);
Gets bounds for the whole chart relative to the given axis map in data coordinates. If axis is invalid, it'll return arbitrary bounds.
Any of minimum
and maximum
may be NULL.
|
a GogAxisMap |
|
location to store minimum for this axis |
|
location to store maximum for this axis |
void gog_axis_map_get_extents (GogAxisMap *map
,double *start
,double *stop
);
Gets start and stop for the whole chart relative to the given axis map in data coordinates. If axis is not inverted, start = minimum and stop = maximum. If axis is invalid, it'll return arbitrary bounds.
Any of start
and stop
may be NULL.
|
a GogAxisMap |
|
location to store start for this axis |
|
location to store stop for this axis |
void gog_axis_map_get_real_bounds (GogAxisMap *map
,double *minimum
,double *maximum
);
Gets bounds for the given axis map in data coordinates. If axis is invalid, it'll return arbitrary bounds.
Any of minimum
and maximum
may be NULL.
|
a GogAxisMap |
|
location to store minimum for this axis |
|
location to store maximum for this axis |
void gog_axis_map_get_real_extents (GogAxisMap *map
,double *start
,double *stop
);
Gets start and stop for the given axis map in data coordinates. If axis is not inverted, start = minimum and stop = maximum. If axis is invalid, it'll return arbitrary bounds.
Any of start
and stop
may be NULL.
|
a GogAxisMap |
|
location to store start for this axis |
|
location to store stop for this axis |
gboolean gog_axis_map_is_discrete (GogAxisMap *map
);
|
a GogAxisMap |
Returns : |
TRUE is the axis is discrete;
|
gboolean gog_axis_map_is_inverted (GogAxisMap *map
);
|
a GogAxisMap |
Returns : |
TRUE is the axis is inverted;
|
gboolean gog_axis_map_is_valid (GogAxisMap *map
);
Tests if map
was correctly initialized, i.e. if bounds are
valid.
|
a GogAxisMap |
Returns : |
TRUE if map is valid
|
GogAxisMap* gog_axis_map_new (GogAxis *axis
,double offset
,double length
);
Creates a GogAxisMap for data mapping to plot window. offset and length are optional parameters to be used with gog_axis_map_to_view in order to translates data coordinates into canvas space.
|
a GogAxis |
|
start of plot area. |
|
length of plot area. |
Returns : |
a newly allocated GogAxisMap. [transfer full] |
double gog_axis_map_to_view (GogAxisMap *map
,double value
);
Converts value from data space to canvas space, using offset and length parameters given to gog_axis_map_new.
|
a GogAxisMap |
|
value to map to canvas space |
Returns : |
a value in canvas coordinates |