Top | ![]() |
![]() |
![]() |
![]() |
GwyBrick represents 3D data arrays in Gwyddion. It is typically useful for different volume data obtained from SPMs, like in force volume measurements.
#define gwy_brick_duplicate(brick)
Convenience macro doing gwy_serializable_duplicate()
with all the necessary
typecasting.
Since: 2.31
GwyBrick * gwy_brick_new (gint xres
,gint yres
,gint zres
,gdouble xreal
,gdouble yreal
,gdouble zreal
,gboolean nullme
);
Creates a new data brick.
xres |
X resolution, i.e., the number of samples in x direction |
|
yres |
Y resolution, i.e., the number of samples in y direction |
|
zres |
Z resolution, i.e., the number of samples in z direction |
|
xreal |
Real physical dimension in x direction. |
|
yreal |
Real physical dimension in y direction. |
|
zreal |
Real physical dimension in z direction. |
|
nullme |
Whether the data brick should be initialized to zeroes. If |
Since: 2.31
GwyBrick * gwy_brick_new_alike (GwyBrick *model
,gboolean nullme
);
Creates a new data brick similar to an existing one.
Use gwy_brick_duplicate()
if you want to copy a data brick including
data.
model |
A data brick to take resolutions and units from. |
|
nullme |
Whether the data brick should be initialized to zeroes. If |
Since: 2.31
GwyBrick * gwy_brick_new_part (const GwyBrick *brick
,gint xpos
,gint ypos
,gint zpos
,gint xres
,gint yres
,gint zres
,gboolean keep_offsets
);
Creates a new data brick as a part of existing one.
Use gwy_brick_duplicate()
if you want to copy a whole data brick.
brick |
A data brick to take data from |
|
xpos |
x position where to start from |
|
ypos |
y position where to start from |
|
zpos |
z position where to start from |
|
xres |
x resolution (width) to be extracted |
|
yres |
y resolution (height) to be extracted |
|
zres |
z resolution (depth) to be extracted |
|
keep_offsets |
keep offsets of data during extraction |
Since: 2.32
void
gwy_brick_data_changed (GwyBrick *brick
);
Emits signal "data_changed" on a data brick.
Since: 2.31
void gwy_brick_resample (GwyBrick *brick
,gint xres
,gint yres
,gint zres
,GwyInterpolationType interpolation
);
Resamples a data brick.
In other words changes the size of three dimensional field related with data brick. The original values are used for resampling using a requested interpolation alorithm.
brick |
A data brick. |
|
xres |
Desired x resolution. |
|
yres |
Desired y resolution. |
|
zres |
Desired z resolution. |
|
interpolation |
Interpolation method to use. |
Since: 2.31
gint
gwy_brick_get_xres (GwyBrick *brick
);
Gets the x resolution of a data brick.
Since: 2.31
gint
gwy_brick_get_yres (GwyBrick *brick
);
Gets the y resolution of a data brick.
Since: 2.31
gint
gwy_brick_get_zres (GwyBrick *brick
);
Gets the z resolution of a data brick.
Since: 2.31
gdouble
gwy_brick_get_xreal (GwyBrick *brick
);
Gets the physical size of a data brick in the x direction.
Since: 2.31
gdouble
gwy_brick_get_yreal (GwyBrick *brick
);
Gets the physical size of a data brick in the y direction.
Since: 2.31
gdouble
gwy_brick_get_zreal (GwyBrick *brick
);
Gets the physical size of a data brick in the z direction.
Since: 2.31
gdouble
gwy_brick_get_xoffset (GwyBrick *brick
);
Gets the offset of data brick origin in x direction.
Since: 2.31
gdouble
gwy_brick_get_yoffset (GwyBrick *brick
);
Gets the offset of data brick origin in y direction.
Since: 2.31
gdouble
gwy_brick_get_zoffset (GwyBrick *brick
);
Gets the offset of data brick origin in z direction.
Since: 2.31
const gdouble *
gwy_brick_get_data_const (GwyBrick *brick
);
Gets the raw data buffer of a data brick, read-only.
The returned buffer is not guaranteed to be valid through whole data
brick life time. Some function may change it, most notably
gwy_brick_resample()
.
Use gwy_brick_get_data()
if you want to change the data.
Since: 2.31
void gwy_brick_set_xreal (GwyBrick *brick
,gdouble xreal
);
Sets the real x dimension of a brick.
Since: 2.31
void gwy_brick_set_yreal (GwyBrick *brick
,gdouble yreal
);
Sets the real y dimension of a brick.
Since: 2.31
void gwy_brick_set_zreal (GwyBrick *brick
,gdouble zreal
);
Sets the real z dimension of a brick.
Since: 2.31
void gwy_brick_set_xoffset (GwyBrick *brick
,gdouble xoffset
);
Sets the offset of a data brick origin in the x direction.
Note offsets don't affect any calculation, nor functions like
gwy_brick_rtoi()
.
Since: 2.31
void gwy_brick_set_yoffset (GwyBrick *brick
,gdouble yoffset
);
Sets the offset of a data brick origin in the y direction.
Note offsets don't affect any calculation, nor functions like
gwy_brick_rtoi()
.
Since: 2.31
void gwy_brick_set_zoffset (GwyBrick *brick
,gdouble zoffset
);
Sets the offset of a data brick origin in the z direction.
Note offsets don't affect any calculation, nor functions like
gwy_brick_rtoi()
.
Since: 2.31
GwySIUnit *
gwy_brick_get_si_unit_x (GwyBrick *brick
);
Returns x direction SI unit of a data brick.
SI unit corresponding to the lateral (X) dimension of the data brick. Its reference count is not incremented.
Since: 2.31
GwySIUnit *
gwy_brick_get_si_unit_y (GwyBrick *brick
);
Returns y direction SI unit of a data brick.
SI unit corresponding to the lateral (Y) dimension of the data brick. Its reference count is not incremented.
Since: 2.31
GwySIUnit *
gwy_brick_get_si_unit_z (GwyBrick *brick
);
Returns z direction SI unit of a data brick.
SI unit corresponding to the "height" (Z) dimension of the data brick. Its reference count is not incremented.
Since: 2.31
GwySIUnit *
gwy_brick_get_si_unit_w (GwyBrick *brick
);
Returns value SI unit of a data brick.
SI unit corresponding to the "value" of the data brick. Its reference count is not incremented.
Since: 2.31
void gwy_brick_set_si_unit_x (GwyBrick *brick
,GwySIUnit *si_unit
);
Sets the SI unit corresponding to the lateral (X) dimension of a data brick.
It does not assume a reference on si_unit
, instead it adds its own
reference.
Since: 2.31
void gwy_brick_set_si_unit_y (GwyBrick *brick
,GwySIUnit *si_unit
);
Sets the SI unit corresponding to the lateral (Y) dimension of a data brick.
It does not assume a reference on si_unit
, instead it adds its own
reference.
Since: 2.31
void gwy_brick_set_si_unit_z (GwyBrick *brick
,GwySIUnit *si_unit
);
Sets the SI unit corresponding to the "height" (Z) dimension of a data brick.
It does not assume a reference on si_unit
, instead it adds its own
reference.
Since: 2.31
void gwy_brick_set_si_unit_w (GwyBrick *brick
,GwySIUnit *si_unit
);
Sets the SI unit corresponding to the "value" of a data brick.
It does not assume a reference on si_unit
, instead it adds its own
reference.
Since: 2.31
gdouble
gwy_brick_get_min (GwyBrick *brick
);
Find the minimum value in a data brick.
Since: 2.31
gdouble
gwy_brick_get_max (GwyBrick *brick
);
Find the maximum value in a data brick.
Since: 2.31
void gwy_brick_copy_units (const GwyBrick *brick
,GwyBrick *target
);
Sets lateral and value units of a data brick to match another data brick.
Since: 2.49
GwySIValueFormat * gwy_brick_get_value_format_x (GwyBrick *brick
,GwySIUnitFormatStyle style
,GwySIValueFormat *format
);
Finds value format good for displaying coordinates of a data brick.
brick |
A data brick. |
|
style |
Unit format style. |
|
format |
A SI value format to modify, or |
The value format. If format
is NULL
, a newly allocated format
is returned, otherwise (modified) format
itself is returned.
Since: 2.31
GwySIValueFormat * gwy_brick_get_value_format_y (GwyBrick *brick
,GwySIUnitFormatStyle style
,GwySIValueFormat *format
);
Finds value format good for displaying values of a data brick.
brick |
A data brick. |
|
style |
Unit format style. |
|
format |
A SI value format to modify, or |
The value format. If format
is NULL
, a newly allocated format
is returned, otherwise (modified) format
itself is returned.
Since: 2.31
GwySIValueFormat * gwy_brick_get_value_format_z (GwyBrick *brick
,GwySIUnitFormatStyle style
,GwySIValueFormat *format
);
Finds value format good for displaying values of a data brick.
brick |
A data brick. |
|
style |
Unit format style. |
|
format |
A SI value format to modify, or |
The value format. If format
is NULL
, a newly allocated format
is returned, otherwise (modified) format
itself is returned.
Since: 2.31
GwySIValueFormat * gwy_brick_get_value_format_w (GwyBrick *brick
,GwySIUnitFormatStyle style
,GwySIValueFormat *format
);
Finds value format good for displaying values of a data brick.
Note this functions searches for minimum and maximum value in brick
,
therefore it's relatively slow.
brick |
A data brick. |
|
style |
Unit format style. |
|
format |
A SI value format to modify, or |
The value format. If format
is NULL
, a newly allocated format
is returned, otherwise (modified) format
itself is returned.
Since: 2.31
gdouble *
gwy_brick_get_data (GwyBrick *brick
);
Gets the raw data buffer of a data brick.
The returned buffer is not guaranteed to be valid through whole data
brick life time. Some function may change it, most notably
gwy_brick_resample()
.
This function invalidates any cached information, use
gwy_brick_get_data_const()
if you are not going to change the data.
Since: 2.31
gdouble gwy_brick_itor (GwyBrick *brick
,gdouble pixpos
);
Transforms pixel coordinate to real (physical) coordinate in x direction.
That is it maps range [0..x resolution] to range [0..x real-size]. It is not
suitable for conversion of matrix indices to physical coordinates, you
have to use gwy_brick_itor(brick
, pixpos
+ 0.5) for that.
Since: 2.31
gdouble gwy_brick_rtoi (GwyBrick *brick
,gdouble realpos
);
Transforms real (physical) coordinate to pixel coordinate in x axis.
That is it maps range [0..x real-size] to range [0..x resolution].
Since: 2.31
gdouble gwy_brick_jtor (GwyBrick *brick
,gdouble pixpos
);
Transforms pixel coordinate to real (physical) coordinate in y direction.
That is it maps range [0..y resolution] to range [0..y real-size]. It is not
suitable for conversion of matrix indices to physical coordinates, you
have to use gwy_brick_itor(brick
, pixpos
+ 0.5) for that.
Since: 2.31
gdouble gwy_brick_rtoj (GwyBrick *brick
,gdouble realpos
);
Transforms real (physical) coordinate to pixel coordinate in y axis.
That is it maps range [0..y real-size] to range [0..y resolution].
Since: 2.31
gdouble gwy_brick_ktor (GwyBrick *brick
,gdouble pixpos
);
Transforms pixel coordinate to real (physical) coordinate in z direction.
That is it maps range [0..z resolution] to range [0..z real-size]. It is not
suitable for conversion of matrix indices to physical coordinates, you
have to use gwy_brick_itor(brick
, pixpos
+ 0.5) for that.
Since: 2.31
gdouble gwy_brick_rtok (GwyBrick *brick
,gdouble realpos
);
Transforms real (physical) coordinate to pixel coordinate in z axis.
That is it maps range [0..z real-size] to range [0..z resolution].
Since: 2.31
gdouble gwy_brick_ktor_cal (GwyBrick *brick
,gdouble pixpos
);
Transforms pixel coordinate to real (physical) coordinate in z direction, taking into account calibration.
Unlike gwy_brick_ktor()
, this function takes into account the z
calibration and, if calibration is not present, the z
axis offset.
Since the calibration is available only for discrete pixel coordinates,
the values are interpolated between and clamped if outside the range.
The values in the calibration are assumed to correspond to pixel centres. This convention is also kept when no calibration is present.
Since: 2.42
gdouble gwy_brick_rtok_cal (GwyBrick *brick
,gdouble realpos
);
Transforms real (physical) coordinate to pixel coordinate in z axis, taking into account calibration.
Unlike gwy_brick_rtok()
, this function takes into account the z
calibration and, if calibration is not present, the z
axis offset.
Since the calibration is available only for discrete pixel coordinates,
the values are interpolated between and clamped if outside the range.
The values in the calibration are assumed to correspond to pixel centres. This convention is also kept when no calibration is present.
Since: 2.42
gdouble gwy_brick_get_val (GwyBrick *brick
,gint col
,gint row
,gint lev
);
Gets value at given position in a data brick.
Do not access data with this function inside inner loops, it's slow.
Get raw data buffer with gwy_brick_get_data_const()
and access it
directly instead.
brick |
A data brick. |
|
col |
Position in the brick (column index). |
|
row |
Position in the brick (row index). |
|
lev |
Position in the brick (level index). |
Since: 2.31
void gwy_brick_set_val (GwyBrick *brick
,gint col
,gint row
,gint lev
,gdouble value
);
Sets value at given position in a data brick.
Do not access data with this function inside inner loops, it's slow.
Get raw data buffer with gwy_brick_get_data_const()
and access it
directly instead.
brick |
A data brick. |
|
col |
Position in the brick (column index). |
|
row |
Position in the brick (row index). |
|
lev |
Position in the brick (level index). |
|
value |
Value to be set. |
Since: 2.31
gdouble gwy_brick_get_val_real (GwyBrick *brick
,gdouble x
,gdouble y
,gdouble z
);
Gets value at given position in a data brick, in real coordinates.
Do not access data with this function inside inner loops, it's slow.
Get raw data buffer with gwy_brick_get_data_const()
and access it
directly instead.
brick |
A data brick. |
|
x |
Position in the brick (x direction). |
|
y |
Position in the brick (y direction). |
|
z |
Position in the brick (z direction). |
Since: 2.31
void gwy_brick_set_val_real (GwyBrick *brick
,gdouble x
,gdouble y
,gdouble z
,gdouble value
);
Sets value at given position in a data brick.
Do not access data with this function inside inner loops, it's slow.
Get raw data buffer with gwy_brick_get_data_const()
and access it
directly instead.
brick |
A data brick. |
|
x |
Position in the brick (x direction). |
|
y |
Position in the brick (y direction). |
|
z |
Position in the brick (z direction). |
|
value |
Value to be set. |
Since: 2.31
gdouble gwy_brick_get_dval (GwyBrick *brick
,gdouble x
,gdouble y
,gdouble z
,gint interpolation
);
Gets interpolated value at arbitrary data brick point indexed by pixel coordinates.
Note pixel values are centered in intervals [i
, i
+1].
See also gwy_brick_get_dval_real()
that does the same, but takes
real coordinates.
brick |
A data brick. |
|
x |
Position in data brick in range [0, x resolution]. If the value is outside this range, the nearest border value is returned. |
|
y |
Position in data brick in range [0, y resolution]. If the value is outside this range, the nearest border value is returned. |
|
z |
Position in data brick in range [0, z resolution]. If the value is outside this range, the nearest border value is returned. |
|
interpolation |
Interpolation method to use. |
Since: 2.31
gdouble gwy_brick_get_dval_real (GwyBrick *brick
,gdouble x
,gdouble y
,gdouble z
,gint interpolation
);
Gets interpolated value at arbitrary data brick point indexed by pixel coordinates.
Note pixel values are centered in intervals [j
, j
+1].
See also gwy_brick_get_dval()
that does the same, but takes
pixel coordinates.
brick |
A data brick. |
|
x |
Position in data brick in range [0, x resolution]. If the value is outside this range, the nearest border value is returned. |
|
y |
Position in data brick in range [0, y resolution]. If the value is outside this range, the nearest border value is returned. |
|
z |
Position in data brick in range [0, z resolution]. If the value is outside this range, the nearest border value is returned. |
|
interpolation |
Interpolation method to use. |
Since: 2.31
void
gwy_brick_clear (GwyBrick *brick
);
Fills a data brick with zeroes.
Since: 2.31
void gwy_brick_fill (GwyBrick *brick
,gdouble value
);
Fills a data brick with specified value.
Since: 2.31
void gwy_brick_multiply (GwyBrick *brick
,gdouble value
);
Multiplies all values in a data brick with a specified value.
Since: 2.31
void gwy_brick_add (GwyBrick *brick
,gdouble value
);
Adds a specified value to all values in a data brick.
Since: 2.31
void gwy_brick_extract_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Extract a plane (GwyDataField) from the brick.
One value of set (width
, height
, depth
) needs to be -1, determining the
plane orientation.
brick |
A data brick. |
|
target |
Datafield to be filled by extracted plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of extracted plane. If |
|
height |
Pixel height of extracted plane. If |
|
depth |
Pixel depth of extracted plane. If |
|
keep_offsets |
Keep the physical offsets in extracted field. |
Since: 2.31
void gwy_brick_sum_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Sums planes in certain direction and extract the result (GwyDataField). One
value of set (width
, height
, depth
) needs to be -1, determining the plane
orientation. In contrast to gwy_brick_extract_plane, the appropriate start
coordinate (e.g. istart
if width
= -1) is not used for single plane
extraction, but the planes are accumulated in whole range (0..xres for given
example)
brick |
A data brick. |
|
target |
Datafield to be filled by summed plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summed plane. If |
|
height |
Pixel height of summed plane. If |
|
depth |
Pixel depth of summed plane. If |
|
keep_offsets |
Keep the physical offsets in extracted field. Not implemented. |
Since: 2.31
void gwy_brick_min_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds minima of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the minima plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of summarized plane. If |
|
keep_offsets |
Keep the physical offsets in extracted field. Not implemented. |
Since: 2.32
void gwy_brick_max_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds minima of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the maxima plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of extracted plane. If |
|
keep_offsets |
Keep the physical offsets in extracted field. Not implemented. |
Since: 2.32
void gwy_brick_minpos_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds minima positions of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the minima positions plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of summarized plane. If |
|
keep_offsets |
Keep the physical offsets in summarized field. Not implemented. |
Since: 2.32
void gwy_brick_maxpos_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds maxima positions of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the maxima positions plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of summarized plane. If |
|
keep_offsets |
Keep the physical offsets in summarized field. Not implemented. |
Since: 2.32
void gwy_brick_mean_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds mean of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the mean plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of summarized plane. If |
|
keep_offsets |
Keep the physical offsets in summarized field. Not implemented. |
Since: 2.32
void gwy_brick_rms_plane (const GwyBrick *brick
,GwyDataField *target
,gint istart
,gint jstart
,gint kstart
,gint width
,gint height
,gint depth
,gboolean keep_offsets
);
Finds rms of planes in certain direction and extract the result
(GwyDataField). One value of set (width
, height
, depth
) needs to be -1,
determining the plane orientation. In contrast to gwy_brick_extract_plane,
the appropriate start coordinate (e.g. istart
if width
= -1) is not used
for single plane extraction, but the planes are accumulated in whole range
(0..xres for given example)
brick |
A data brick. |
|
target |
Datafield to be filled by the rms plane. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
width |
Pixel width of summarized plane. If |
|
height |
Pixel height of summarized plane. If |
|
depth |
Pixel depth of summarized plane. If |
|
keep_offsets |
Keep the physical offsets in extracted field. Not implemented. |
Since: 2.32
void gwy_brick_extract_line (const GwyBrick *brick
,GwyDataLine *target
,gint istart
,gint jstart
,gint kstart
,gint iend
,gint jend
,gint kend
,gboolean keep_offsets
);
Extract a line (GwyDataLine) from the brick.
Only line orientations parallel to coordinate axes are supported now, i.e. two of the start coordinates need to be same as end ones.
brick |
A data brick. |
|
target |
Dataline to be filled by extracted line. It will be resized if necessary. |
|
istart |
Column where to start (pixel coordinates). |
|
jstart |
Row where to start (pixel coordinates). |
|
kstart |
Level where to start (pixel coordinates). |
|
iend |
Column where to start (pixel coordinates). |
|
jend |
Row where to start (pixel coordinates). |
|
kend |
Level where to start (pixel coordinates). |
|
keep_offsets |
Keep physical offsets in extracted line. |
Since: 2.31
GwyDataLine *
gwy_brick_get_zcalibration (const GwyBrick *brick
);
Gets the z-axis non-linear calibration of a data brick.
Since: 2.32
void gwy_brick_set_zcalibration (const GwyBrick *brick
,GwyDataLine *calibration
);
Sets the z-axis non-linear calibration of a data brick.
brick |
A data brick. |
|
calibration |
GwyDataLine pointer with z-axis non-linear calibration
of a data brick (values are stored as ordinates). It can also
be |
Since: 2.32
struct GwyBrick;
The GwyBrick struct contains private data only and should be accessed using the functions below.
Since: 2.31
struct GwyBrickClass { GObjectClass parent_class; void (*data_changed)(GwyBrick *brick); };
“data-changed”
signalvoid user_function (GwyBrick *gwydataline, gpointer user_data)
The ::data-changed signal is never emitted by data line itself. It is intended as a means to notify others data line users they should update themselves.
gwydataline |
The GwyBrick which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First