1be6408590
2002-05-13 Sven Neumann <sven@gimp.org> * libgimpwidgets/libgimpwidgets-docs.sgml: added GimpStock section, removed GimpWidgetTypes. * libgimpwidgets/libgimpwidgets-sections.txt: updated. * libgimpwidgets/tmpl/gimpstock.sgml: added GimpStock templates. * libgimpwidgets/tmpl/gimpwidgetstypes.sgml: removed. * libgimpwidgets/tmpl/gimpbutton.sgml * libgimpwidgets/tmpl/gimpchainbutton.sgml * libgimpwidgets/tmpl/gimpcolorarea.sgml * libgimpwidgets/tmpl/gimpcolorbutton.sgml * libgimpwidgets/tmpl/gimpdialog.sgml * libgimpwidgets/tmpl/gimpfileselection.sgml * libgimpwidgets/tmpl/gimphelpui.sgml * libgimpwidgets/tmpl/gimpoffsetarea.sgml * libgimpwidgets/tmpl/gimppatheditor.sgml * libgimpwidgets/tmpl/gimppixmap.sgml * libgimpwidgets/tmpl/gimpquerybox.sgml * libgimpwidgets/tmpl/gimpsizeentry.sgml * libgimpwidgets/tmpl/gimpunitmenu.sgml * libgimpwidgets/tmpl/gimpwidgets.sgml: updated.
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.
|
|
|