mirror of https://github.com/GNOME/gimp.git
247 lines
3.7 KiB
Plaintext
247 lines
3.7 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GimpSizeEntry
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Widget for entering pixel values and resolutions.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
This widget is used to enter pixel distances/sizes and resolutions.
|
|
</para>
|
|
<para>
|
|
You can specify the number of fields the widget should provide. For
|
|
each field automatic mappings are performed between the field's
|
|
"reference value" and it's "value".
|
|
</para>
|
|
<para>
|
|
There is a #GimpUnitMenu right of the entry fields which lets you
|
|
specify the #GimpUnit of the displayed values.
|
|
</para>
|
|
<para>
|
|
For each field, there can be one or two #GtkSpinButton's to enter
|
|
"value" and "reference value". If you specify @show_refval as #FALSE
|
|
in gimp_size_entry_new() there will be only one #GtkSpinButton and the
|
|
#GimpUnitMenu will contain an item for selecting GIMP_UNIT_PIXEL.
|
|
</para>
|
|
<para>
|
|
The "reference value" is either of GIMP_UNIT_PIXEL or dpi, depending
|
|
on which #GimpSizeEntryUpdatePolicy you specify in gimp_size_entry_new().
|
|
The "value" is either the size in pixels mapped to the size in a
|
|
real-world-unit (see #GimpUnit) or the dpi value mapped to pixels per
|
|
real-world-unit.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GimpUnit
|
|
</para>
|
|
<para>
|
|
#GimpUnitMenu
|
|
</para>
|
|
<para>
|
|
gimp_coordinates_new()
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GimpSizeEntry ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### STRUCT GimpSizeEntryField ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### ENUM GimpSizeEntryUpdatePolicy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@GIMP_SIZE_ENTRY_UPDATE_NONE:
|
|
@GIMP_SIZE_ENTRY_UPDATE_SIZE:
|
|
@GIMP_SIZE_ENTRY_UPDATE_RESOLUTION:
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@number_of_fields:
|
|
@unit:
|
|
@unit_format:
|
|
@menu_show_pixels:
|
|
@menu_show_percent:
|
|
@show_refval:
|
|
@spinbutton_width:
|
|
@update_policy:
|
|
@Returns:
|
|
<!-- # Unused Parameters # -->
|
|
@spinbutton_usize:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_add_field ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@value_spinbutton:
|
|
@refval_spinbutton:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_attach_label ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@text:
|
|
@row:
|
|
@column:
|
|
@alignment:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_resolution ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@resolution:
|
|
@keep_size:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_size ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@lower:
|
|
@upper:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_value_boundaries ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@lower:
|
|
@upper:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_get_value ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_value ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@value:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_refval_boundaries ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@lower:
|
|
@upper:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_refval_digits ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@digits:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_get_refval ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_refval ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@field:
|
|
@refval:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_get_unit ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_set_unit ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_size_entry_grab_focus ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gse:
|
|
|
|
|
|
<!-- ##### SIGNAL GimpSizeEntry::refval-changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gimpsizeentry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GimpSizeEntry::unit-changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gimpsizeentry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GimpSizeEntry::value-changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gimpsizeentry: the object which received the signal.
|
|
|