<?xml version="1.0"?>
<page id="GimpUi.coordinates_new"
      type="topic"
      style="function"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="index" group="function" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>Gtk.Widget</api:type>
      </api:returns>
      <api:name>gimp_coordinates_new</api:name>
      <api:arg>
        <api:type>Gimp.Unit</api:type>
        <api:name>unit</api:name>
      </api:arg>
      <api:arg>
        <api:type>String</api:type>
        <api:name>unit_format</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>menu_show_pixels</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>menu_show_percent</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gint)</api:type>
        <api:name>spinbutton_width</api:name>
      </api:arg>
      <api:arg>
        <api:type>GimpUi.SizeEntryUpdatePolicy</api:type>
        <api:name>update_policy</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>chainbutton_active</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>chain_constrains_ratio</api:name>
      </api:arg>
      <api:arg>
        <api:type>String</api:type>
        <api:name>xlabel</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>x</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>xres</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>lower_boundary_x</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>upper_boundary_x</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>xsize_0</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>xsize_100</api:name>
      </api:arg>
      <api:arg>
        <api:type>String</api:type>
        <api:name>ylabel</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>y</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>yres</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>lower_boundary_y</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>upper_boundary_y</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>ysize_0</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gdouble)</api:type>
        <api:name>ysize_100</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>GimpUi.coordinates_new</title>
  <synopsis><code mime="text/x-gjs">
function coordinates_new(unit: <link href="../Gimp-3.0/Gimp.Unit.html">Gimp.Unit</link>, unit_format: String, menu_show_pixels: Boolean, menu_show_percent: Boolean, spinbutton_width: Number(gint), update_policy: <link xref="GimpUi.SizeEntryUpdatePolicy">GimpUi.SizeEntryUpdatePolicy</link>, chainbutton_active: Boolean, chain_constrains_ratio: Boolean, xlabel: String, x: Number(gdouble), xres: Number(gdouble), lower_boundary_x: Number(gdouble), upper_boundary_x: Number(gdouble), xsize_0: Number(gdouble), xsize_100: Number(gdouble), ylabel: String, y: Number(gdouble), yres: Number(gdouble), lower_boundary_y: Number(gdouble), upper_boundary_y: Number(gdouble), ysize_0: Number(gdouble), ysize_100: Number(gdouble)): <link href="../Gtk-3.0/Gtk.Widget.html">Gtk.Widget</link> {
    // Gjs wrapper for gimp_coordinates_new()
}
  </code></synopsis>
  <p>Convenience function that creates a <link xref="GimpUi.SizeEntry"/> with two fields for x/y
coordinates/sizes with a <link xref="GimpUi.ChainButton"/> attached to constrain either the
two fields' values or the ratio between them.</p>

<terms>
<item>
<title><code>unit</code></title>
  <p>The initial unit of the #GimpUnitMenu.</p>
</item>
<item>
<title><code>unit_format</code></title>
  <p>A printf-like unit-format string as is used with
                         gimp_unit_menu_new().</p>
</item>
<item>
<title><code>menu_show_pixels</code></title>
  <p><code>true</code> if the #GimpUnitMenu should contain an item
                         for GIMP_UNIT_PIXEL.</p>
</item>
<item>
<title><code>menu_show_percent</code></title>
  <p><code>true</code> if the #GimpUnitMenu should contain an item
                         for GIMP_UNIT_PERCENT.</p>
</item>
<item>
<title><code>spinbutton_width</code></title>
  <p>The horizontal size of the <link xref="GimpUi.SizeEntry"/>'s
                          <link href="../Gtk-3.0/Gtk.SpinButton.html">Gtk.SpinButton</link>'s.</p>
</item>
<item>
<title><code>update_policy</code></title>
  <p>The update policy for the <link xref="GimpUi.SizeEntry"/>.</p>
</item>
<item>
<title><code>chainbutton_active</code></title>
  <p><code>true</code> if the attached <link xref="GimpUi.ChainButton"/> should be
                         active.</p>
</item>
<item>
<title><code>chain_constrains_ratio</code></title>
  <p><code>true</code> if the chainbutton should constrain the
                         fields' aspect ratio. If <code>false</code>, the values will
                         be constrained.</p>
</item>
<item>
<title><code>xlabel</code></title>
  <p>The label for the X coordinate.</p>
</item>
<item>
<title><code>x</code></title>
  <p>The initial value of the X coordinate.</p>
</item>
<item>
<title><code>xres</code></title>
  <p>The horizontal resolution in DPI.</p>
</item>
<item>
<title><code>lower_boundary_x</code></title>
  <p>The lower boundary of the X coordinate.</p>
</item>
<item>
<title><code>upper_boundary_x</code></title>
  <p>The upper boundary of the X coordinate.</p>
</item>
<item>
<title><code>xsize_0</code></title>
  <p>The X value which will be treated as 0%.</p>
</item>
<item>
<title><code>xsize_100</code></title>
  <p>The X value which will be treated as 100%.</p>
</item>
<item>
<title><code>ylabel</code></title>
  <p>The label for the Y coordinate.</p>
</item>
<item>
<title><code>y</code></title>
  <p>The initial value of the Y coordinate.</p>
</item>
<item>
<title><code>yres</code></title>
  <p>The vertical resolution in DPI.</p>
</item>
<item>
<title><code>lower_boundary_y</code></title>
  <p>The lower boundary of the Y coordinate.</p>
</item>
<item>
<title><code>upper_boundary_y</code></title>
  <p>The upper boundary of the Y coordinate.</p>
</item>
<item>
<title><code>ysize_0</code></title>
  <p>The Y value which will be treated as 0%.</p>
</item>
<item>
<title><code>ysize_100</code></title>
  <p>The Y value which will be treated as 100%.</p>
</item>
<item>
<title><code>Returns</code></title>
  <p>The new <link xref="GimpUi.SizeEntry"/>.</p>
</item>
</terms>

</page>
