libui-ng
A portable GUI library for C
ui.h
Go to the documentation of this file.
1// 6 april 2015
2
3// TODO add a uiVerifyControlType() function that can be used by control implementations to verify controls
4
5// TODOs
6// - make getters that return whether something exists accept a NULL pointer to discard the value (and thus only return that the thing exists?)
7// - const-correct everything
8// - normalize documentation between typedefs and structs
9
20#ifndef __LIBUI_UI_H__
21#define __LIBUI_UI_H__
22
23#include <stddef.h>
24#include <stdint.h>
25
26#ifdef __cplusplus
27extern "C" {
28#endif
29
30// this macro is generated by cmake
31#ifdef libui_EXPORTS
32#ifdef _WIN32
33#define _UI_EXTERN __declspec(dllexport) extern
34#else
35#define _UI_EXTERN __attribute__((visibility("default"))) extern
36#endif
37#else
38// TODO add __declspec(dllimport) on windows, but only if not static
39#define _UI_EXTERN extern
40#endif
41
42// C++ is really really really really really really dumb about enums, so screw that and just make them anonymous
43// This has the advantage of being ABI-able should we ever need an ABI...
44#define _UI_ENUM(s) typedef unsigned int s; enum
45
46// This constant is provided because M_PI is nonstandard.
47// This comes from Go's math.Pi, which in turn comes from http://oeis.org/A000796.
48#define uiPi 3.14159265358979323846264338327950288419716939937510582097494459
49
50// TODO uiBool?
51
52// uiForEach represents the return value from one of libui's various ForEach functions.
56};
57
59
61 size_t Size;
62};
63
64_UI_EXTERN const char *uiInit(uiInitOptions *options);
66_UI_EXTERN void uiFreeInitError(const char *err);
67
68_UI_EXTERN void uiMain(void);
70_UI_EXTERN int uiMainStep(int wait);
71_UI_EXTERN void uiQuit(void);
72
73_UI_EXTERN void uiQueueMain(void (*f)(void *data), void *data);
74
75// TODO standardize the looping behavior return type, either with some enum or something, and the test expressions throughout the code
76// TODO figure out what to do about looping and the exact point that the timer is rescheduled so we can document it; see https://github.com/andlabs/libui/pull/277
77// TODO (also in the above link) document that this cannot be called from any thread, unlike uiQueueMain()
78// TODO document that the minimum exact timing, either accuracy (timer burst, etc.) or granularity (15ms on Windows, etc.), is OS-defined
79// TODO also figure out how long until the initial tick is registered on all platforms to document
80// TODO also add a comment about how useful this could be in bindings, depending on the language being bound to
81_UI_EXTERN void uiTimer(int milliseconds, int (*f)(void *data), void *data);
82
83_UI_EXTERN void uiOnShouldQuit(int (*f)(void *data), void *data);
84
85
95_UI_EXTERN void uiFreeText(char *text);
96
97
103typedef struct uiControl uiControl;
104struct uiControl {
105 uint32_t Signature;
106 uint32_t OSSignature;
108 void (*Destroy)(uiControl *);
109 uintptr_t (*Handle)(uiControl *);
110 uiControl *(*Parent)(uiControl *);
114 void (*Show)(uiControl *);
115 void (*Hide)(uiControl *);
117 void (*Enable)(uiControl *);
118 void (*Disable)(uiControl *);
119};
120// TOOD add argument names to all arguments
121#define uiControl(this) ((uiControl *) (this))
122
135
144
153
163
172
181
189
198
209
217
225
235_UI_EXTERN uiControl *uiAllocControl(size_t n, uint32_t OSsig, uint32_t typesig, const char *typenamestr);
236
246
257
270
271// TODO Move this to private API? According to old/new.md this should be used by toplevel controls.
273
274
290typedef struct uiWindow uiWindow;
291#define uiWindow(this) ((uiWindow *) (this))
292
303
314_UI_EXTERN void uiWindowSetTitle(uiWindow *w, const char *title);
315
327_UI_EXTERN void uiWindowPosition(uiWindow *w, int *x, int *y);
328
341
356 void (*f)(uiWindow *sender, void *senderData), void *data);
357
367_UI_EXTERN void uiWindowContentSize(uiWindow *w, int *width, int *height);
368
379_UI_EXTERN void uiWindowSetContentSize(uiWindow *w, int width, int height);
380
389
399
414 void (*f)(uiWindow *sender, void *senderData), void *data);
415
432 int (*f)(uiWindow *sender, void *senderData), void *data);
433
447 void (*f)(uiWindow *sender, void *senderData), void *data);
448
457
466
476
485
494
505
514
524
537_UI_EXTERN uiWindow *uiNewWindow(const char *title, int width, int height, int hasMenubar);
538
539
547typedef struct uiButton uiButton;
548#define uiButton(this) ((uiButton *) (this))
549
560
570_UI_EXTERN void uiButtonSetText(uiButton *b, const char *text);
571
585 void (*f)(uiButton *sender, void *senderData), void *data);
586
596_UI_EXTERN uiButton *uiNewButton(const char *text);
597
598
609typedef struct uiBox uiBox;
610#define uiBox(this) ((uiBox *) (this))
611
623_UI_EXTERN void uiBoxAppend(uiBox *b, uiControl *child, int stretchy);
624
633
642_UI_EXTERN void uiBoxDelete(uiBox *b, int index);
643
654
665_UI_EXTERN void uiBoxSetPadded(uiBox *b, int padded);
666
676
686
687
695typedef struct uiCheckbox uiCheckbox;
696#define uiCheckbox(this) ((uiCheckbox *) (this))
697
708
718_UI_EXTERN void uiCheckboxSetText(uiCheckbox *c, const char *text);
719
734 void (*f)(uiCheckbox *sender, void *senderData), void *data);
735
744
753
764
765
773typedef struct uiEntry uiEntry;
774#define uiEntry(this) ((uiEntry *) (this))
775
786
796_UI_EXTERN void uiEntrySetText(uiEntry *e, const char *text);
797
811 void (*f)(uiEntry *sender, void *senderData), void *data);
812
821
829_UI_EXTERN void uiEntrySetReadOnly(uiEntry *e, int readonly);
830
838
848
859
860
868typedef struct uiLabel uiLabel;
869#define uiLabel(this) ((uiLabel *) (this))
870
881
891_UI_EXTERN void uiLabelSetText(uiLabel *l, const char *text);
892
902_UI_EXTERN uiLabel *uiNewLabel(const char *text);
903
904
915typedef struct uiTab uiTab;
916#define uiTab(this) ((uiTab *) (this))
917
928_UI_EXTERN void uiTabAppend(uiTab *t, const char *name, uiControl *c);
929
941_UI_EXTERN void uiTabInsertAt(uiTab *t, const char *name, int index, uiControl *c);
942
951_UI_EXTERN void uiTabDelete(uiTab *t, int index);
952
961
970_UI_EXTERN int uiTabMargined(uiTab *t, int index);
971
982_UI_EXTERN void uiTabSetMargined(uiTab *t, int index, int margined);
983
991
992
1006typedef struct uiGroup uiGroup;
1007#define uiGroup(this) ((uiGroup *) (this))
1008
1019
1029_UI_EXTERN void uiGroupSetTitle(uiGroup *g, const char *title);
1030
1039
1048
1059
1069_UI_EXTERN uiGroup *uiNewGroup(const char *title);
1070
1071
1087typedef struct uiSpinbox uiSpinbox;
1088#define uiSpinbox(this) ((uiSpinbox *) (this))
1089
1098
1108
1123 void (*f)(uiSpinbox *sender, void *senderData), void *data);
1124
1140
1141
1156typedef struct uiSlider uiSlider;
1157#define uiSlider(this) ((uiSlider *) (this))
1158
1167
1176
1185
1194
1209 void (*f)(uiSlider *sender, void *senderData), void *data);
1210
1224 void (*f)(uiSlider *sender, void *senderData), void *data);
1225
1236_UI_EXTERN void uiSliderSetRange(uiSlider *s, int min, int max);
1237
1253
1254
1265#define uiProgressBar(this) ((uiProgressBar *) (this))
1266
1275
1290
1298
1299
1308#define uiSeparator(this) ((uiSeparator *) (this))
1309
1317
1325
1326
1335typedef struct uiCombobox uiCombobox;
1336#define uiCombobox(this) ((uiCombobox *) (this))
1337
1347_UI_EXTERN void uiComboboxAppend(uiCombobox *c, const char *text);
1348
1359_UI_EXTERN void uiComboboxInsertAt(uiCombobox *c, int index, const char *text);
1360
1372
1380
1389
1398
1407
1423 void (*f)(uiCombobox *sender, void *senderData), void *data);
1424
1432
1433
1447#define uiEditableCombobox(this) ((uiEditableCombobox *) (this))
1448
1459
1473
1484
1485// TODO what do we call a function that sets the currently selected item and fills the text field with it?
1486// editable comboboxes have no consistent concept of selected item
1487
1502 void (*f)(uiEditableCombobox *sender, void *senderData), void *data);
1503
1511
1512
1521#define uiRadioButtons(this) ((uiRadioButtons *) (this))
1522
1533
1542
1551
1566 void (*f)(uiRadioButtons *sender, void *senderData), void *data);
1567
1575
1576struct tm;
1594#define uiDateTimePicker(this) ((uiDateTimePicker *) (this))
1595
1605
1616
1631 void (*f)(uiDateTimePicker *sender, void *senderData), void *data);
1632
1640
1648
1656
1657
1667#define uiMultilineEntry(this) ((uiMultilineEntry *) (this))
1668
1679
1690
1701
1717 void (*f)(uiMultilineEntry *sender, void *senderData), void *data);
1718
1727
1736
1744
1754
1755
1762typedef struct uiMenuItem uiMenuItem;
1763#define uiMenuItem(this) ((uiMenuItem *) (this))
1764
1772
1782
1797 void (*f)(uiMenuItem *sender, uiWindow *window, void *senderData), void *data);
1798
1809
1820
1849typedef struct uiMenu uiMenu;
1850#define uiMenu(this) ((uiMenu *) (this))
1851
1863
1875
1885
1895
1905
1913
1925_UI_EXTERN uiMenu *uiNewMenu(const char *name);
1926
1927
1940
1953
1969
1984_UI_EXTERN void uiMsgBox(uiWindow *parent, const char *title, const char *description);
1985
2001_UI_EXTERN void uiMsgBoxError(uiWindow *parent, const char *title, const char *description);
2002
2003typedef struct uiArea uiArea;
2008
2010
2013 // TODO document that resizes cause a full redraw for non-scrolling areas; implementation-defined for scrolling areas
2015 // TODO document that on first show if the mouse is already in the uiArea then one gets sent with left=0
2016 // TODO what about when the area is hidden and then shown again?
2017 void (*MouseCrossed)(uiAreaHandler *, uiArea *, int left);
2020};
2021
2022// TODO RTL layouts?
2023// TODO reconcile edge and corner naming
2033 // TODO have one for keyboard resizes?
2034 // TODO GDK doesn't seem to have any others, including for keyboards...
2035 // TODO way to bring up the system menu instead?
2036};
2037
2038#define uiArea(this) ((uiArea *) (this))
2039// TODO give a better name
2040// TODO document the types of width and height
2041_UI_EXTERN void uiAreaSetSize(uiArea *a, int width, int height);
2042// TODO uiAreaQueueRedraw()
2044_UI_EXTERN void uiAreaScrollTo(uiArea *a, double x, double y, double width, double height);
2045// TODO document these can only be called within Mouse() handlers
2046// TODO should these be allowed on scrolling areas?
2047// TODO decide which mouse events should be accepted; Down is the only one guaranteed to work right now
2048// TODO what happens to events after calling this up to and including the next mouse up?
2049// TODO release capture?
2054
2057
2058 // TODO document that this is only defined for nonscrolling areas
2061
2062 double ClipX;
2063 double ClipY;
2066};
2067
2068typedef struct uiDrawPath uiDrawPath;
2072
2074
2080};
2081
2086};
2087
2092};
2093
2094// this is the default for botoh cairo and Direct2D (in the latter case, from the C++ helper functions)
2095// Core Graphics doesn't explicitly specify a default, but NSBezierPath allows you to choose one, and this is the initial value
2096// so we're good to use it too!
2097#define uiDrawDefaultMiterLimit 10.0
2098
2102};
2103
2105 double M11;
2106 double M12;
2107 double M21;
2108 double M22;
2109 double M31;
2110 double M32;
2111};
2112
2115
2116 // solid brushes
2117 double R;
2118 double G;
2119 double B;
2120 double A;
2121
2122 // gradient brushes
2123 double X0; // linear: start X, radial: start X
2124 double Y0; // linear: start Y, radial: start Y
2125 double X1; // linear: end X, radial: outer circle center X
2126 double Y1; // linear: end Y, radial: outer circle center Y
2127 double OuterRadius; // radial gradients only
2129 size_t NumStops;
2130 // TODO extend mode
2131 // cairo: none, repeat, reflect, pad; no individual control
2132 // Direct2D: repeat, reflect, pad; no individual control
2133 // Core Graphics: none, pad; before and after individually
2134 // TODO cairo documentation is inconsistent about pad
2135
2136 // TODO images
2137
2138 // TODO transforms
2139};
2140
2142 double Pos;
2143 double R;
2144 double G;
2145 double B;
2146 double A;
2147};
2148
2152 // TODO what if this is 0? on windows there will be a crash with dashing
2155 double *Dashes;
2156 // TOOD what if this is 1 on Direct2D?
2157 // TODO what if a dash is 0 on Cairo or Quartz?
2160};
2161
2164
2165_UI_EXTERN void uiDrawPathNewFigure(uiDrawPath *p, double x, double y);
2166_UI_EXTERN void uiDrawPathNewFigureWithArc(uiDrawPath *p, double xCenter, double yCenter, double radius, double startAngle, double sweep, int negative);
2167_UI_EXTERN void uiDrawPathLineTo(uiDrawPath *p, double x, double y);
2168// notes: angles are both relative to 0 and go counterclockwise
2169// TODO is the initial line segment on cairo and OS X a proper join?
2170// TODO what if sweep < 0?
2171_UI_EXTERN void uiDrawPathArcTo(uiDrawPath *p, double xCenter, double yCenter, double radius, double startAngle, double sweep, int negative);
2172_UI_EXTERN void uiDrawPathBezierTo(uiDrawPath *p, double c1x, double c1y, double c2x, double c2y, double endX, double endY);
2173// TODO quadratic bezier
2175
2176// TODO effect of these when a figure is already started
2177_UI_EXTERN void uiDrawPathAddRectangle(uiDrawPath *p, double x, double y, double width, double height);
2178
2181
2184
2185// TODO primitives:
2186// - rounded rectangles
2187// - elliptical arcs
2188// - quadratic bezier curves
2189
2191_UI_EXTERN void uiDrawMatrixTranslate(uiDrawMatrix *m, double x, double y);
2192_UI_EXTERN void uiDrawMatrixScale(uiDrawMatrix *m, double xCenter, double yCenter, double x, double y);
2193_UI_EXTERN void uiDrawMatrixRotate(uiDrawMatrix *m, double x, double y, double amount);
2194_UI_EXTERN void uiDrawMatrixSkew(uiDrawMatrix *m, double x, double y, double xamount, double yamount);
2200
2202
2203// TODO add a uiDrawPathStrokeToFill() or something like that
2205
2208
2209// uiAttribute stores information about an attribute in a
2210// uiAttributedString.
2211//
2212// You do not create uiAttributes directly; instead, you create a
2213// uiAttribute of a given type using the specialized constructor
2214// functions. For every Unicode codepoint in the uiAttributedString,
2215// at most one value of each attribute type can be applied.
2216//
2217// uiAttributes are immutable and the uiAttributedString takes
2218// ownership of the uiAttribute object once assigned, copying its
2219// contents as necessary.
2220// TODO define whether all this, for both uiTableValue and uiAttribute, is undefined behavior or a caught error
2222
2223// @role uiAttribute destructor
2224// uiFreeAttribute() frees a uiAttribute. You generally do not need to
2225// call this yourself, as uiAttributedString does this for you. In fact,
2226// it is an error to call this function on a uiAttribute that has been
2227// given to a uiAttributedString. You can call this, however, if you
2228// created a uiAttribute that you aren't going to use later.
2230
2231// uiAttributeType holds the possible uiAttribute types that may be
2232// returned by uiAttributeGetType(). Refer to the documentation for
2233// each type's constructor function for details on each type.
2245};
2246
2247// uiAttributeGetType() returns the type of a.
2248// TODO I don't like this name
2250
2251// uiNewFamilyAttribute() creates a new uiAttribute that changes the
2252// font family of the text it is applied to. family is copied; you do not
2253// need to keep it alive after uiNewFamilyAttribute() returns. Font
2254// family names are case-insensitive.
2256
2257// uiAttributeFamily() returns the font family stored in a. The
2258// returned string is owned by a. It is an error to call this on a
2259// uiAttribute that does not hold a font family.
2261
2262// uiNewSizeAttribute() creates a new uiAttribute that changes the
2263// size of the text it is applied to, in typographical points.
2265
2266// uiAttributeSize() returns the font size stored in a. It is an error to
2267// call this on a uiAttribute that does not hold a font size.
2269
2270// uiTextWeight represents possible text weights. These roughly
2271// map to the OS/2 text weight field of TrueType and OpenType
2272// fonts, or to CSS weight numbers. The named constants are
2273// nominal values; the actual values may vary by font and by OS,
2274// though this isn't particularly likely. Any value between
2275// uiTextWeightMinimum and uiTextWeightMaximum, inclusive,
2276// is allowed.
2277//
2278// Note that due to restrictions in early versions of Windows, some
2279// fonts have "special" weights be exposed in many programs as
2280// separate font families. This is perhaps most notable with
2281// Arial Black. libui does not do this, even on Windows (because the
2282// DirectWrite API libui uses on Windows does not do this); to
2283// specify Arial Black, use family Arial and weight uiTextWeightBlack.
2298};
2299
2300// uiNewWeightAttribute() creates a new uiAttribute that changes the
2301// weight of the text it is applied to. It is an error to specify a weight
2302// outside the range [uiTextWeightMinimum,
2303// uiTextWeightMaximum].
2305
2306// uiAttributeWeight() returns the font weight stored in a. It is an error
2307// to call this on a uiAttribute that does not hold a font weight.
2309
2310// uiTextItalic represents possible italic modes for a font. Italic
2311// represents "true" italics where the slanted glyphs have custom
2312// shapes, whereas oblique represents italics that are merely slanted
2313// versions of the normal glyphs. Most fonts usually have one or the
2314// other.
2319};
2320
2321// uiNewItalicAttribute() creates a new uiAttribute that changes the
2322// italic mode of the text it is applied to. It is an error to specify an
2323// italic mode not specified in uiTextItalic.
2325
2326// uiAttributeItalic() returns the font italic mode stored in a. It is an
2327// error to call this on a uiAttribute that does not hold a font italic
2328// mode.
2330
2331// uiTextStretch represents possible stretches (also called "widths")
2332// of a font.
2333//
2334// Note that due to restrictions in early versions of Windows, some
2335// fonts have "special" stretches be exposed in many programs as
2336// separate font families. This is perhaps most notable with
2337// Arial Condensed. libui does not do this, even on Windows (because
2338// the DirectWrite API libui uses on Windows does not do this); to
2339// specify Arial Condensed, use family Arial and stretch
2340// uiTextStretchCondensed.
2351};
2352
2353// uiNewStretchAttribute() creates a new uiAttribute that changes the
2354// stretch of the text it is applied to. It is an error to specify a strech
2355// not specified in uiTextStretch.
2357
2358// uiAttributeStretch() returns the font stretch stored in a. It is an
2359// error to call this on a uiAttribute that does not hold a font stretch.
2361
2362// uiNewColorAttribute() creates a new uiAttribute that changes the
2363// color of the text it is applied to. It is an error to specify an invalid
2364// color.
2365_UI_EXTERN uiAttribute *uiNewColorAttribute(double r, double g, double b, double a);
2366
2367// uiAttributeColor() returns the text color stored in a. It is an
2368// error to call this on a uiAttribute that does not hold a text color.
2369_UI_EXTERN void uiAttributeColor(const uiAttribute *a, double *r, double *g, double *b, double *alpha);
2370
2371// uiNewBackgroundAttribute() creates a new uiAttribute that
2372// changes the background color of the text it is applied to. It is an
2373// error to specify an invalid color.
2374_UI_EXTERN uiAttribute *uiNewBackgroundAttribute(double r, double g, double b, double a);
2375
2376// TODO reuse uiAttributeColor() for background colors, or make a new function...
2377
2378// uiUnderline specifies a type of underline to use on text.
2383 uiUnderlineSuggestion, // wavy or dotted underlines used for spelling/grammar checkers
2384};
2385
2386// uiNewUnderlineAttribute() creates a new uiAttribute that changes
2387// the type of underline on the text it is applied to. It is an error to
2388// specify an underline type not specified in uiUnderline.
2390
2391// uiAttributeUnderline() returns the underline type stored in a. It is
2392// an error to call this on a uiAttribute that does not hold an underline
2393// style.
2395
2396// uiUnderlineColor specifies the color of any underline on the text it
2397// is applied to, regardless of the type of underline. In addition to
2398// being able to specify a custom color, you can explicitly specify
2399// platform-specific colors for suggestion underlines; to use them
2400// correctly, pair them with uiUnderlineSuggestion (though they can
2401// be used on other types of underline as well).
2402//
2403// If an underline type is applied but no underline color is
2404// specified, the text color is used instead. If an underline color
2405// is specified without an underline type, the underline color
2406// attribute is ignored, but not removed from the uiAttributedString.
2411 uiUnderlineColorAuxiliary, // for instance, the color used by smart replacements on macOS or in Microsoft Office
2412};
2413
2414// uiNewUnderlineColorAttribute() creates a new uiAttribute that
2415// changes the color of the underline on the text it is applied to.
2416// It is an error to specify an underline color not specified in
2417// uiUnderlineColor.
2418//
2419// If the specified color type is uiUnderlineColorCustom, it is an
2420// error to specify an invalid color value. Otherwise, the color values
2421// are ignored and should be specified as zero.
2422_UI_EXTERN uiAttribute *uiNewUnderlineColorAttribute(uiUnderlineColor u, double r, double g, double b, double a);
2423
2424// uiAttributeUnderlineColor() returns the underline color stored in
2425// a. It is an error to call this on a uiAttribute that does not hold an
2426// underline color.
2427_UI_EXTERN void uiAttributeUnderlineColor(const uiAttribute *a, uiUnderlineColor *u, double *r, double *g, double *b, double *alpha);
2428
2429// uiOpenTypeFeatures represents a set of OpenType feature
2430// tag-value pairs, for applying OpenType features to text.
2431// OpenType feature tags are four-character codes defined by
2432// OpenType that cover things from design features like small
2433// caps and swashes to language-specific glyph shapes and
2434// beyond. Each tag may only appear once in any given
2435// uiOpenTypeFeatures instance. Each value is a 32-bit integer,
2436// often used as a Boolean flag, but sometimes as an index to choose
2437// a glyph shape to use.
2438//
2439// If a font does not support a certain feature, that feature will be
2440// ignored. (TODO verify this on all OSs)
2441//
2442// See the OpenType specification at
2443// https://www.microsoft.com/typography/otspec/featuretags.htm
2444// for the complete list of available features, information on specific
2445// features, and how to use them.
2446// TODO invalid features
2448
2449// uiOpenTypeFeaturesForEachFunc is the type of the function
2450// invoked by uiOpenTypeFeaturesForEach() for every OpenType
2451// feature in otf. Refer to that function's documentation for more
2452// details.
2453typedef uiForEach (*uiOpenTypeFeaturesForEachFunc)(const uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t value, void *data);
2454
2455// @role uiOpenTypeFeatures constructor
2456// uiNewOpenTypeFeatures() returns a new uiOpenTypeFeatures
2457// instance, with no tags yet added.
2459
2460// @role uiOpenTypeFeatures destructor
2461// uiFreeOpenTypeFeatures() frees otf.
2463
2464// uiOpenTypeFeaturesClone() makes a copy of otf and returns it.
2465// Changing one will not affect the other.
2467
2468// uiOpenTypeFeaturesAdd() adds the given feature tag and value
2469// to otf. The feature tag is specified by a, b, c, and d. If there is
2470// already a value associated with the specified tag in otf, the old
2471// value is removed.
2472_UI_EXTERN void uiOpenTypeFeaturesAdd(uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t value);
2473
2474// uiOpenTypeFeaturesRemove() removes the given feature tag
2475// and value from otf. If the tag is not present in otf,
2476// uiOpenTypeFeaturesRemove() does nothing.
2477_UI_EXTERN void uiOpenTypeFeaturesRemove(uiOpenTypeFeatures *otf, char a, char b, char c, char d);
2478
2479// uiOpenTypeFeaturesGet() determines whether the given feature
2480// tag is present in otf. If it is, *value is set to the tag's value and
2481// nonzero is returned. Otherwise, zero is returned.
2482//
2483// Note that if uiOpenTypeFeaturesGet() returns zero, value isn't
2484// changed. This is important: if a feature is not present in a
2485// uiOpenTypeFeatures, the feature is NOT treated as if its
2486// value was zero anyway. Script-specific font shaping rules and
2487// font-specific feature settings may use a different default value
2488// for a feature. You should likewise not treat a missing feature as
2489// having a value of zero either. Instead, a missing feature should
2490// be treated as having some unspecified default value.
2491_UI_EXTERN int uiOpenTypeFeaturesGet(const uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t *value);
2492
2493// uiOpenTypeFeaturesForEach() executes f for every tag-value
2494// pair in otf. The enumeration order is unspecified. You cannot
2495// modify otf while uiOpenTypeFeaturesForEach() is running.
2497
2498// uiNewFeaturesAttribute() creates a new uiAttribute that changes
2499// the font family of the text it is applied to. otf is copied; you may
2500// free it after uiNewFeaturesAttribute() returns.
2502
2503// uiAttributeFeatures() returns the OpenType features stored in a.
2504// The returned uiOpenTypeFeatures object is owned by a. It is an
2505// error to call this on a uiAttribute that does not hold OpenType
2506// features.
2508
2509// uiAttributedString represents a string of UTF-8 text that can
2510// optionally be embellished with formatting attributes. libui
2511// provides the list of formatting attributes, which cover common
2512// formatting traits like boldface and color as well as advanced
2513// typographical features provided by OpenType like superscripts
2514// and small caps. These attributes can be combined in a variety of
2515// ways.
2516//
2517// Attributes are applied to runs of Unicode codepoints in the string.
2518// Zero-length runs are elided. Consecutive runs that have the same
2519// attribute type and value are merged. Each attribute is independent
2520// of each other attribute; overlapping attributes of different types
2521// do not split each other apart, but different values of the same
2522// attribute type do.
2523//
2524// The empty string can also be represented by uiAttributedString,
2525// but because of the no-zero-length-attribute rule, it will not have
2526// attributes.
2527//
2528// A uiAttributedString takes ownership of all attributes given to
2529// it, as it may need to duplicate or delete uiAttribute objects at
2530// any time. By extension, when you free a uiAttributedString,
2531// all uiAttributes within will also be freed. Each method will
2532// describe its own rules in more details.
2533//
2534// In addition, uiAttributedString provides facilities for moving
2535// between grapheme clusters, which represent a character
2536// from the point of view of the end user. The cursor of a text editor
2537// is always placed on a grapheme boundary, so you can use these
2538// features to move the cursor left or right by one "character".
2539// TODO does uiAttributedString itself need this
2540//
2541// uiAttributedString does not provide enough information to be able
2542// to draw itself onto a uiDrawContext or respond to user actions.
2543// In order to do that, you'll need to use a uiDrawTextLayout, which
2544// is built from the combination of a uiAttributedString and a set of
2545// layout-specific properties.
2547
2548// uiAttributedStringForEachAttributeFunc is the type of the function
2549// invoked by uiAttributedStringForEachAttribute() for every
2550// attribute in s. Refer to that function's documentation for more
2551// details.
2552typedef uiForEach (*uiAttributedStringForEachAttributeFunc)(const uiAttributedString *s, const uiAttribute *a, size_t start, size_t end, void *data);
2553
2554// @role uiAttributedString constructor
2555// uiNewAttributedString() creates a new uiAttributedString from
2556// initialString. The string will be entirely unattributed.
2558
2559// @role uiAttributedString destructor
2560// uiFreeAttributedString() destroys the uiAttributedString s.
2561// It will also free all uiAttributes within.
2563
2564// uiAttributedStringString() returns the textual content of s as a
2565// '\0'-terminated UTF-8 string. The returned pointer is valid until
2566// the next change to the textual content of s.
2568
2569// uiAttributedStringLength() returns the number of UTF-8 bytes in
2570// the textual content of s, excluding the terminating '\0'.
2572
2573// uiAttributedStringAppendUnattributed() adds the '\0'-terminated
2574// UTF-8 string str to the end of s. The new substring will be
2575// unattributed.
2577
2578// uiAttributedStringInsertAtUnattributed() adds the '\0'-terminated
2579// UTF-8 string str to s at the byte position specified by at. The new
2580// substring will be unattributed; existing attributes will be moved
2581// along with their text.
2583
2584// TODO add the Append and InsertAtExtendingAttributes functions
2585// TODO and add functions that take a string + length
2586
2587// uiAttributedStringDelete() deletes the characters and attributes of
2588// s in the byte range [start, end).
2589_UI_EXTERN void uiAttributedStringDelete(uiAttributedString *s, size_t start, size_t end);
2590
2591// TODO add a function to uiAttributedString to get an attribute's value at a specific index or in a specific range, so we can edit
2592
2593// uiAttributedStringSetAttribute() sets a in the byte range [start, end)
2594// of s. Any existing attributes in that byte range of the same type are
2595// removed. s takes ownership of a; you should not use it after
2596// uiAttributedStringSetAttribute() returns.
2598
2599// uiAttributedStringForEachAttribute() enumerates all the
2600// uiAttributes in s. It is an error to modify s in f. Within f, s still
2601// owns the attribute; you can neither free it nor save it for later
2602// use.
2603// TODO reword the above for consistency (TODO and find out what I meant by that)
2604// TODO define an enumeration order (or mark it as undefined); also define how consecutive runs of identical attributes are handled here and sync with the definition of uiAttributedString itself
2606
2607// TODO const correct this somehow (the implementation needs to mutate the structure)
2609
2610// TODO const correct this somehow (the implementation needs to mutate the structure)
2612
2613// TODO const correct this somehow (the implementation needs to mutate the structure)
2615
2616// uiFontDescriptor provides a complete description of a font where
2617// one is needed. Currently, this means as the default font of a
2618// uiDrawTextLayout and as the data returned by uiFontButton.
2619// All the members operate like the respective uiAttributes.
2621
2623 // TODO const-correct this or figure out how to deal with this when getting a value
2624 char *Family;
2625 double Size;
2629};
2630
2633
2634// uiDrawTextLayout is a concrete representation of a
2635// uiAttributedString that can be displayed in a uiDrawContext.
2636// It includes information important for the drawing of a block of
2637// text, including the bounding box to wrap the text within, the
2638// alignment of lines of text within that box, areas to mark as
2639// being selected, and other things.
2640//
2641// Unlike uiAttributedString, the content of a uiDrawTextLayout is
2642// immutable once it has been created.
2643//
2644// TODO talk about OS-specific differences with text drawing that libui can't account for...
2646
2647// uiDrawTextAlign specifies the alignment of lines of text in a
2648// uiDrawTextLayout.
2649// TODO should this really have Draw in the name?
2654};
2655
2656// uiDrawTextLayoutParams describes a uiDrawTextLayout.
2657// DefaultFont is used to render any text that is not attributed
2658// sufficiently in String. Width determines the width of the bounding
2659// box of the text; the height is determined automatically.
2661
2662// TODO const-correct this somehow
2666 double Width;
2668};
2669
2670// @role uiDrawTextLayout constructor
2671// uiDrawNewTextLayout() creates a new uiDrawTextLayout from
2672// the given parameters.
2673//
2674// TODO
2675// - allow creating a layout out of a substring
2676// - allow marking compositon strings
2677// - allow marking selections, even after creation
2678// - add the following functions:
2679// - uiDrawTextLayoutHeightForWidth() (returns the height that a layout would need to be to display the entire string at a given width)
2680// - uiDrawTextLayoutRangeForSize() (returns what substring would fit in a given size)
2681// - uiDrawTextLayoutNewWithHeight() (limits amount of string used by the height)
2682// - some function to fix up a range (for text editing)
2684
2685// @role uiDrawFreeTextLayout destructor
2686// uiDrawFreeTextLayout() frees tl. The underlying
2687// uiAttributedString is not freed.
2689
2690// uiDrawText() draws tl in c with the top-left point of tl at (x, y).
2691_UI_EXTERN void uiDrawText(uiDrawContext *c, uiDrawTextLayout *tl, double x, double y);
2692
2693// uiDrawTextLayoutExtents() returns the width and height of tl
2694// in width and height. The returned width may be smaller than
2695// the width passed into uiDrawNewTextLayout() depending on
2696// how the text in tl is wrapped. Therefore, you can use this
2697// function to get the actual size of the text layout.
2698_UI_EXTERN void uiDrawTextLayoutExtents(uiDrawTextLayout *tl, double *width, double *height);
2699
2700// TODO metrics functions
2701
2702// TODO number of lines visible for clipping rect, range visible for clipping rect?
2703
2704
2716#define uiFontButton(this) ((uiFontButton *) (this))
2717
2728
2742 void (*f)(uiFontButton *sender, void *senderData), void *data);
2743
2753
2767
2777 uiModifierAlt = 1 << 1,
2780};
2781
2782// TODO document drag captures
2784 // TODO document what these mean for scrolling areas
2785 double X;
2786 double Y;
2787
2788 // TODO see draw above
2791
2792 int Down;
2793 int Up;
2794
2796
2798
2799 uint64_t Held1To64;
2800};
2801
2804 uiExtKeyInsert, // equivalent to "Help" on Apple keyboards
2814 uiExtKeyF1, // F1..F12 are guaranteed to be consecutive
2826 uiExtKeyN0, // numpad keys; independent of Num Lock state
2827 uiExtKeyN1, // N0..N9 are guaranteed to be consecutive
2842};
2843
2845 char Key;
2848
2850
2851 int Up;
2852};
2853
2854
2868#define uiColorButton(this) ((uiColorButton *) (this))
2869
2880_UI_EXTERN void uiColorButtonColor(uiColorButton *b, double *r, double *g, double *bl, double *a);
2881
2892_UI_EXTERN void uiColorButtonSetColor(uiColorButton *b, double r, double g, double bl, double a);
2893
2907 void (*f)(uiColorButton *sender, void *senderData), void *data);
2908
2916
2917
2933typedef struct uiForm uiForm;
2934#define uiForm(this) ((uiForm *) (this))
2935
2950_UI_EXTERN void uiFormAppend(uiForm *f, const char *label, uiControl *c, int stretchy);
2951
2959
2968_UI_EXTERN void uiFormDelete(uiForm *f, int index);
2969
2980
2991_UI_EXTERN void uiFormSetPadded(uiForm *f, int padded);
2992
3000
3001
3013};
3014
3026};
3027
3049typedef struct uiGrid uiGrid;
3050#define uiGrid(this) ((uiGrid *) (this))
3051
3067_UI_EXTERN void uiGridAppend(uiGrid *g, uiControl *c, int left, int top, int xspan, int yspan, int hexpand, uiAlign halign, int vexpand, uiAlign valign);
3068
3084_UI_EXTERN void uiGridInsertAt(uiGrid *g, uiControl *c, uiControl *existing, uiAt at, int xspan, int yspan, int hexpand, uiAlign halign, int vexpand, uiAlign valign);
3085
3096
3107_UI_EXTERN void uiGridSetPadded(uiGrid *g, int padded);
3108
3116
3117
3138typedef struct uiImage uiImage;
3139
3151_UI_EXTERN uiImage *uiNewImage(double width, double height);
3152
3160
3177_UI_EXTERN void uiImageAppend(uiImage *i, void *pixels, int pixelWidth, int pixelHeight, int byteStride);
3178
3228
3243
3256};
3257
3266
3277
3290
3306
3320
3334
3345
3356_UI_EXTERN uiTableValue *uiNewTableValueColor(double r, double g, double b, double a);
3357
3370_UI_EXTERN void uiTableValueColor(const uiTableValue *v, double *r, double *g, double *b, double *a);
3371
3372
3386
3409
3434
3442
3447
3460 uiTableValue *(*CellValue)(uiTableModelHandler *mh, uiTableModel *m, int row, int column);
3461
3475};
3476
3485
3495
3508
3520
3533// TODO reordering/moving
3534
3536#define uiTableModelColumnNeverEditable (-1)
3538#define uiTableModelColumnAlwaysEditable (-2)
3539
3557};
3558
3580};
3581
3603typedef struct uiTable uiTable;
3604#define uiTable(this) ((uiTable *) (this))
3605
3624 const char *name,
3625 int textModelColumn,
3626 int textEditableModelColumn,
3628
3644 const char *name,
3645 int imageModelColumn);
3646
3669 const char *name,
3670 int imageModelColumn,
3671 int textModelColumn,
3672 int textEditableModelColumn,
3674
3691 const char *name,
3692 int checkboxModelColumn,
3693 int checkboxEditableModelColumn);
3694
3719 const char *name,
3720 int checkboxModelColumn,
3721 int checkboxEditableModelColumn,
3722 int textModelColumn,
3723 int textEditableModelColumn,
3725
3742 const char *name,
3743 int progressModelColumn);
3744
3766 const char *name,
3767 int buttonModelColumn,
3768 int buttonClickableModelColumn);
3769
3778
3787
3796
3797
3812 void (*f)(uiTable *t, int row, void *data),
3813 void *data);
3814
3832 void (*f)(uiTable *t, int row, void *data),
3833 void *data);
3834
3848 int column,
3849 uiSortIndicator indicator);
3850
3860
3875 void (*f)(uiTable *sender, int column, void *senderData), void *data);
3876
3886
3900_UI_EXTERN void uiTableColumnSetWidth(uiTable *t, int column, int width);
3901
3925};
3926
3936
3948
3963_UI_EXTERN void uiTableOnSelectionChanged(uiTable *t, void (*f)(uiTable *t, void *data), void *data);
3964
3973{
3975 int *Rows;
3976};
3977
3989
4002
4010
4011#ifdef __cplusplus
4012}
4013#endif
4014
4015#endif
char * uiOpenFolder(uiWindow *parent)
Folder chooser dialog window to select a single folder.
char * uiSaveFile(uiWindow *parent)
Save file dialog window.
char * uiOpenFile(uiWindow *parent)
File chooser dialog window to select a single file.
void uiMsgBoxError(uiWindow *parent, const char *title, const char *description)
Error message box dialog window.
void uiMsgBox(uiWindow *parent, const char *title, const char *description)
Message box dialog window.
uiTableSelectionMode
Table selection modes.
Definition: ui.h:3914
uiSortIndicator
Sort indicators.
Definition: ui.h:3381
Definition: ui.h:2055
double AreaWidth
Definition: ui.h:2059
double ClipWidth
Definition: ui.h:2064
double ClipHeight
Definition: ui.h:2065
double AreaHeight
Definition: ui.h:2060
double ClipY
Definition: ui.h:2063
uiDrawContext * Context
Definition: ui.h:2056
double ClipX
Definition: ui.h:2062
Definition: ui.h:2011
void(* DragBroken)(uiAreaHandler *, uiArea *)
Definition: ui.h:2018
int(* KeyEvent)(uiAreaHandler *, uiArea *, uiAreaKeyEvent *)
Definition: ui.h:2019
void(* Draw)(uiAreaHandler *, uiArea *, uiAreaDrawParams *)
Definition: ui.h:2012
void(* MouseCrossed)(uiAreaHandler *, uiArea *, int left)
Definition: ui.h:2017
void(* MouseEvent)(uiAreaHandler *, uiArea *, uiAreaMouseEvent *)
Definition: ui.h:2014
Definition: ui.h:2844
char Key
Definition: ui.h:2845
int Up
Definition: ui.h:2851
uiExtKey ExtKey
Definition: ui.h:2846
uiModifiers Modifier
Definition: ui.h:2847
uiModifiers Modifiers
Definition: ui.h:2849
Definition: ui.h:2783
int Count
Definition: ui.h:2795
double X
Definition: ui.h:2785
double AreaHeight
Definition: ui.h:2790
int Down
Definition: ui.h:2792
uint64_t Held1To64
Definition: ui.h:2799
int Up
Definition: ui.h:2793
uiModifiers Modifiers
Definition: ui.h:2797
double Y
Definition: ui.h:2786
double AreaWidth
Definition: ui.h:2789
A boxlike container that holds a group of controls.
void uiBoxDelete(uiBox *b, int index)
Removes the control at index from the box.
uiBox * uiNewHorizontalBox(void)
Creates a new horizontal box.
void uiBoxSetPadded(uiBox *b, int padded)
Sets whether or not controls within the box are padded.
int uiBoxNumChildren(uiBox *b)
Returns the number of controls contained within the box.
void uiBoxAppend(uiBox *b, uiControl *child, int stretchy)
Appends a control to the box.
uiBox * uiNewVerticalBox(void)
Creates a new vertical box.
int uiBoxPadded(uiBox *b)
Returns whether or not controls within the box are padded.
A control that visually represents a button to be clicked by the user to trigger an action.
char * uiButtonText(uiButton *b)
Returns the button label text.
void uiButtonOnClicked(uiButton *b, void(*f)(uiButton *sender, void *senderData), void *data)
Registers a callback for when the button is clicked.
void uiButtonSetText(uiButton *b, const char *text)
Sets the button label text.
uiButton * uiNewButton(const char *text)
Creates a new button.
A control with a user checkable box accompanied by a text label.
void uiCheckboxSetChecked(uiCheckbox *c, int checked)
Sets whether or not the checkbox is checked.
uiCheckbox * uiNewCheckbox(const char *text)
Creates a new checkbox.
char * uiCheckboxText(uiCheckbox *c)
Returns the checkbox label text.
int uiCheckboxChecked(uiCheckbox *c)
Returns whether or the checkbox is checked.
void uiCheckboxOnToggled(uiCheckbox *c, void(*f)(uiCheckbox *sender, void *senderData), void *data)
Registers a callback for when the checkbox is toggled by the user.
void uiCheckboxSetText(uiCheckbox *c, const char *text)
Sets the checkbox label text.
A control with a color indicator that opens a color chooser when clicked.
uiColorButton * uiNewColorButton(void)
Creates a new color button.
void uiColorButtonOnChanged(uiColorButton *b, void(*f)(uiColorButton *sender, void *senderData), void *data)
Registers a callback for when the color is changed.
void uiColorButtonColor(uiColorButton *b, double *r, double *g, double *bl, double *a)
Returns the color button color.
void uiColorButtonSetColor(uiColorButton *b, double r, double g, double bl, double a)
Sets the color button color.
A control to select one item from a predefined list of items via a drop down menu.
void uiComboboxInsertAt(uiCombobox *c, int index, const char *text)
Inserts an item at index to the combo box.
void uiComboboxDelete(uiCombobox *c, int index)
Deletes an item at index from the combo box.
void uiComboboxClear(uiCombobox *c)
Deletes all items from the combo box.
void uiComboboxOnSelected(uiCombobox *c, void(*f)(uiCombobox *sender, void *senderData), void *data)
Registers a callback for when a combo box item is selected.
void uiComboboxAppend(uiCombobox *c, const char *text)
Appends an item to the combo box.
uiCombobox * uiNewCombobox(void)
Creates a new combo box.
void uiComboboxSetSelected(uiCombobox *c, int index)
Sets the item selected.
int uiComboboxSelected(uiCombobox *c)
Returns the index of the item selected.
int uiComboboxNumItems(uiCombobox *c)
Returns the number of items contained within the combo box.
Base class for GUI controls providing common methods.
Definition: ui.h:104
int uiControlVisible(uiControl *c)
Returns whether or not the control is visible.
void uiControlHide(uiControl *c)
Hides the control.
int(* Visible)(uiControl *)
Definition: ui.h:113
uint32_t OSSignature
Definition: ui.h:106
int(* Toplevel)(uiControl *)
Definition: ui.h:112
void(* SetParent)(uiControl *, uiControl *)
Definition: ui.h:111
int uiControlEnabledToUser(uiControl *c)
Returns whether or not the control can be interacted with by the user.
void uiControlDisable(uiControl *c)
Disables the control.
void uiControlDestroy(uiControl *c)
Dispose and free all allocated resources.
void uiControlEnable(uiControl *c)
Enables the control.
void(* Disable)(uiControl *)
Definition: ui.h:118
void(* Show)(uiControl *)
Definition: ui.h:114
void(* Destroy)(uiControl *)
Definition: ui.h:108
int uiControlEnabled(uiControl *c)
Returns whether or not the control is enabled.
uintptr_t uiControlHandle(uiControl *c)
Returns the control's OS-level handle.
void uiControlShow(uiControl *c)
Shows the control.
void uiFreeControl(uiControl *c)
Frees the memory associated with the control reference.
void uiControlVerifySetParent(uiControl *c, uiControl *parent)
Makes sure the control's parent can be set to parent.
int uiControlToplevel(uiControl *c)
Returns whether or not the control is a top level control.
void(* Hide)(uiControl *)
Definition: ui.h:115
void uiControlSetParent(uiControl *c, uiControl *parent)
Sets the control's parent.
uint32_t TypeSignature
Definition: ui.h:107
int(* Enabled)(uiControl *)
Definition: ui.h:116
uiControl * uiAllocControl(size_t n, uint32_t OSsig, uint32_t typesig, const char *typenamestr)
Allocates a uiControl.
uint32_t Signature
Definition: ui.h:105
uiControl * uiControlParent(uiControl *c)
Returns the parent control.
uintptr_t(* Handle)(uiControl *)
Definition: ui.h:109
void(* Enable)(uiControl *)
Definition: ui.h:117
A control to enter a date and/or time.
Definition: ui.h:1576
uiDateTimePicker * uiNewDateTimePicker(void)
Creates a new date picker.
void uiDateTimePickerOnChanged(uiDateTimePicker *d, void(*f)(uiDateTimePicker *sender, void *senderData), void *data)
Registers a callback for when the date time picker value is changed by the user.
void uiDateTimePickerSetTime(uiDateTimePicker *d, const struct tm *time)
Sets date and time of the data time picker.
uiDateTimePicker * uiNewTimePicker(void)
Creates a new date and time picker.
uiDateTimePicker * uiNewDatePicker(void)
Creates a new time picker.
void uiDateTimePickerTime(uiDateTimePicker *d, struct tm *time)
Returns date and time stored in the data time picker.
Definition: ui.h:2141
double R
Definition: ui.h:2143
double G
Definition: ui.h:2144
double Pos
Definition: ui.h:2142
double B
Definition: ui.h:2145
double A
Definition: ui.h:2146
Definition: ui.h:2113
double Y1
Definition: ui.h:2126
double B
Definition: ui.h:2119
size_t NumStops
Definition: ui.h:2129
double R
Definition: ui.h:2117
double Y0
Definition: ui.h:2124
double A
Definition: ui.h:2120
uiDrawBrushGradientStop * Stops
Definition: ui.h:2128
double X1
Definition: ui.h:2125
double X0
Definition: ui.h:2123
double OuterRadius
Definition: ui.h:2127
double G
Definition: ui.h:2118
uiDrawBrushType Type
Definition: ui.h:2114
Definition: ui.h:2104
double M32
Definition: ui.h:2110
double M11
Definition: ui.h:2105
double M22
Definition: ui.h:2108
double M31
Definition: ui.h:2109
double M21
Definition: ui.h:2107
double M12
Definition: ui.h:2106
Definition: ui.h:2149
size_t NumDashes
Definition: ui.h:2158
double DashPhase
Definition: ui.h:2159
double * Dashes
Definition: ui.h:2155
double Thickness
Definition: ui.h:2153
double MiterLimit
Definition: ui.h:2154
uiDrawLineJoin Join
Definition: ui.h:2151
uiDrawLineCap Cap
Definition: ui.h:2150
Definition: ui.h:2663
uiAttributedString * String
Definition: ui.h:2664
double Width
Definition: ui.h:2666
uiFontDescriptor * DefaultFont
Definition: ui.h:2665
uiDrawTextAlign Align
Definition: ui.h:2667
A control to select one item from a predefined list of items or enter ones own.
uiEditableCombobox * uiNewEditableCombobox(void)
Creates a new editable combo box.
void uiEditableComboboxOnChanged(uiEditableCombobox *c, void(*f)(uiEditableCombobox *sender, void *senderData), void *data)
Registers a callback for when an editable combo box item is selected or user text changed.
void uiEditableComboboxSetText(uiEditableCombobox *c, const char *text)
Sets the editable combo box text.
char * uiEditableComboboxText(uiEditableCombobox *c)
Returns the text of the editable combo box.
void uiEditableComboboxAppend(uiEditableCombobox *c, const char *text)
Appends an item to the editable combo box.
A control with a single line text entry field.
uiEntry * uiNewEntry(void)
Creates a new entry.
void uiEntryOnChanged(uiEntry *e, void(*f)(uiEntry *sender, void *senderData), void *data)
Registers a callback for when the user changes the entry's text.
char * uiEntryText(uiEntry *e)
Returns the entry's text.
void uiEntrySetText(uiEntry *e, const char *text)
Sets the entry's text.
uiEntry * uiNewPasswordEntry(void)
Creates a new entry suitable for sensitive inputs like passwords.
void uiEntrySetReadOnly(uiEntry *e, int readonly)
Sets whether or not the entry's text is read only.
uiEntry * uiNewSearchEntry(void)
Creates a new entry suitable for search.
int uiEntryReadOnly(uiEntry *e)
Returns whether or not the entry's text can be changed.
A button-like control that opens a font chooser when clicked.
void uiFontButtonOnChanged(uiFontButton *b, void(*f)(uiFontButton *sender, void *senderData), void *data)
Registers a callback for when the font is changed.
void uiFontButtonFont(uiFontButton *b, uiFontDescriptor *desc)
Returns the selected font.
uiFontButton * uiNewFontButton(void)
Creates a new font button.
void uiFreeFontButtonFont(uiFontDescriptor *desc)
Frees a uiFontDescriptor previously filled by uiFontButtonFont().
Definition: ui.h:2622
uiTextItalic Italic
Definition: ui.h:2627
uiTextWeight Weight
Definition: ui.h:2626
char * Family
Definition: ui.h:2624
uiTextStretch Stretch
Definition: ui.h:2628
double Size
Definition: ui.h:2625
A container control to organize contained controls as labeled fields.
void uiFormSetPadded(uiForm *f, int padded)
Sets whether or not controls within the box are padded.
int uiFormPadded(uiForm *f)
Returns whether or not controls within the form are padded.
void uiFormDelete(uiForm *f, int index)
Removes the control at index from the form.
void uiFormAppend(uiForm *f, const char *label, uiControl *c, int stretchy)
Appends a control with a label to the form.
uiForm * uiNewForm(void)
Creates a new form.
int uiFormNumChildren(uiForm *f)
Returns the number of controls contained within the form.
A control container to arrange containing controls in a grid.
void uiGridSetPadded(uiGrid *g, int padded)
Sets whether or not controls within the grid are padded.
int uiGridPadded(uiGrid *g)
Returns whether or not controls within the grid are padded.
void uiGridAppend(uiGrid *g, uiControl *c, int left, int top, int xspan, int yspan, int hexpand, uiAlign halign, int vexpand, uiAlign valign)
Appends a control to the grid.
uiGrid * uiNewGrid(void)
Creates a new grid.
void uiGridInsertAt(uiGrid *g, uiControl *c, uiControl *existing, uiAt at, int xspan, int yspan, int hexpand, uiAlign halign, int vexpand, uiAlign valign)
Inserts a control positioned in relation to another control within the grid.
A control container that adds a label to the contained child control.
void uiGroupSetTitle(uiGroup *g, const char *title)
Sets the group title.
uiGroup * uiNewGroup(const char *title)
Creates a new group.
void uiGroupSetChild(uiGroup *g, uiControl *c)
Sets the group's child.
char * uiGroupTitle(uiGroup *g)
Returns the group title.
void uiGroupSetMargined(uiGroup *g, int margined)
Sets whether or not the group has a margin.
int uiGroupMargined(uiGroup *g)
Returns whether or not the group has a margin.
A container for an image to be displayed on screen.
uiImage * uiNewImage(double width, double height)
Creates a new image container.
void uiImageAppend(uiImage *i, void *pixels, int pixelWidth, int pixelHeight, int byteStride)
Appends a new image representation.
void uiFreeImage(uiImage *i)
Frees the image container and all associated resources.
Definition: ui.h:60
size_t Size
Definition: ui.h:61
A control that displays non interactive text.
char * uiLabelText(uiLabel *l)
Returns the label text.
uiLabel * uiNewLabel(const char *text)
Creates a new label.
void uiLabelSetText(uiLabel *l, const char *text)
Sets the label text.
An application level menu bar.
uiMenuItem * uiMenuAppendAboutItem(uiMenu *m)
Appends a new About menu item.
uiMenuItem * uiMenuAppendItem(uiMenu *m, const char *name)
Appends a generic menu item.
uiMenuItem * uiMenuAppendQuitItem(uiMenu *m)
Appends a new Quit menu item.
uiMenuItem * uiMenuAppendPreferencesItem(uiMenu *m)
Appends a new Preferences menu item.
void uiMenuAppendSeparator(uiMenu *m)
Appends a new separator.
uiMenuItem * uiMenuAppendCheckItem(uiMenu *m, const char *name)
Appends a generic menu item with a checkbox.
uiMenu * uiNewMenu(const char *name)
Creates a new menu.
A menu item used in conjunction with uiMenu.
void uiMenuItemDisable(uiMenuItem *m)
Disables the menu item.
int uiMenuItemChecked(uiMenuItem *m)
Returns whether or not the menu item's checkbox is checked.
void uiMenuItemOnClicked(uiMenuItem *m, void(*f)(uiMenuItem *sender, uiWindow *window, void *senderData), void *data)
Registers a callback for when the menu item is clicked.
void uiMenuItemEnable(uiMenuItem *m)
Enables the menu item.
void uiMenuItemSetChecked(uiMenuItem *m, int checked)
Sets whether or not the menu item's checkbox is checked.
A control with a multi line text entry field.
void uiMultilineEntryOnChanged(uiMultilineEntry *e, void(*f)(uiMultilineEntry *sender, void *senderData), void *data)
Registers a callback for when the user changes the multi line entry's text.
void uiMultilineEntryAppend(uiMultilineEntry *e, const char *text)
Appends text to the multi line entry's text.
void uiMultilineEntrySetReadOnly(uiMultilineEntry *e, int readonly)
Sets whether or not the multi line entry's text is read only.
uiMultilineEntry * uiNewMultilineEntry(void)
Creates a new multi line entry that visually wraps text when lines overflow.
void uiMultilineEntrySetText(uiMultilineEntry *e, const char *text)
Sets the multi line entry's text.
uiMultilineEntry * uiNewNonWrappingMultilineEntry(void)
Creates a new multi line entry that scrolls horizontally when lines overflow.
char * uiMultilineEntryText(uiMultilineEntry *e)
Returns the multi line entry's text.
int uiMultilineEntryReadOnly(uiMultilineEntry *e)
Returns whether or not the multi line entry's text can be changed.
A control that visualizes the progress of a task via the fill level of a horizontal bar.
uiProgressBar * uiNewProgressBar(void)
Creates a new progress bar.
void uiProgressBarSetValue(uiProgressBar *p, int n)
Sets the progress bar value.
int uiProgressBarValue(uiProgressBar *p)
Returns the progress bar value.
A multiple choice control of check buttons from which only one can be selected at a time.
void uiRadioButtonsSetSelected(uiRadioButtons *r, int index)
Sets the item selected.
void uiRadioButtonsAppend(uiRadioButtons *r, const char *text)
Appends a radio button.
int uiRadioButtonsSelected(uiRadioButtons *r)
Returns the index of the item selected.
void uiRadioButtonsOnSelected(uiRadioButtons *r, void(*f)(uiRadioButtons *sender, void *senderData), void *data)
Registers a callback for when radio button is selected.
uiRadioButtons * uiNewRadioButtons(void)
Creates a new radio buttons instance.
A control to visually separate controls, horizontally or vertically.
uiSeparator * uiNewHorizontalSeparator(void)
Creates a new horizontal separator to separate controls being stacked vertically.
uiSeparator * uiNewVerticalSeparator(void)
Creates a new vertical separator to separate controls being stacked horizontally.
A control to display and modify integer values via a user draggable slider.
void uiSliderOnReleased(uiSlider *s, void(*f)(uiSlider *sender, void *senderData), void *data)
Registers a callback for when the slider is released from dragging.
uiSlider * uiNewSlider(int min, int max)
Creates a new slider.
int uiSliderHasToolTip(uiSlider *s)
Returns whether or not the slider has a tool tip.
int uiSliderValue(uiSlider *s)
Returns the slider value.
void uiSliderSetValue(uiSlider *s, int value)
Sets the slider value.
void uiSliderOnChanged(uiSlider *s, void(*f)(uiSlider *sender, void *senderData), void *data)
Registers a callback for when the slider value is changed by the user.
void uiSliderSetHasToolTip(uiSlider *s, int hasToolTip)
Sets whether or not the slider has a tool tip.
void uiSliderSetRange(uiSlider *s, int min, int max)
Sets the slider range.
A control to display and modify integer values via a text field or +/- buttons.
void uiSpinboxOnChanged(uiSpinbox *s, void(*f)(uiSpinbox *sender, void *senderData), void *data)
Registers a callback for when the spinbox value is changed by the user.
void uiSpinboxSetValue(uiSpinbox *s, int value)
Sets the spinbox value.
uiSpinbox * uiNewSpinbox(int min, int max)
Creates a new spinbox.
int uiSpinboxValue(uiSpinbox *s)
Returns the spinbox value.
A multi page control interface that displays one page at a time.
void uiTabAppend(uiTab *t, const char *name, uiControl *c)
Appends a control in form of a page/tab with label.
void uiTabSetMargined(uiTab *t, int index, int margined)
Sets whether or not the page/tab at index has a margin.
int uiTabNumPages(uiTab *t)
Returns the number of pages contained.
int uiTabMargined(uiTab *t, int index)
Returns whether or not the page/tab at index has a margin.
void uiTabInsertAt(uiTab *t, const char *name, int index, uiControl *c)
Inserts a control in form of a page/tab with label at index.
void uiTabDelete(uiTab *t, int index)
Removes the control at index.
uiTab * uiNewTab(void)
Creates a new tab container.
A control to display data in a tabular fashion.
void uiTableAppendButtonColumn(uiTable *t, const char *name, int buttonModelColumn, int buttonClickableModelColumn)
Appends a column to the table containing a button.
void uiTableOnRowDoubleClicked(uiTable *t, void(*f)(uiTable *t, int row, void *data), void *data)
Registers a callback for when the user double clicks a table row.
uiTableSelection * uiTableGetSelection(uiTable *t)
Returns the current table selection.
void uiTableOnRowClicked(uiTable *t, void(*f)(uiTable *t, int row, void *data), void *data)
Registers a callback for when the user single clicks a table row.
void uiTableColumnSetWidth(uiTable *t, int column, int width)
Sets the table column width.
uiSortIndicator uiTableHeaderSortIndicator(uiTable *t, int column)
Returns the column's sort indicator displayed in the table header.
int uiTableHeaderVisible(uiTable *t)
Returns whether or not the table header is visible.
void uiTableAppendImageTextColumn(uiTable *t, const char *name, int imageModelColumn, int textModelColumn, int textEditableModelColumn, uiTableTextColumnOptionalParams *textParams)
Appends a column to the table that displays both an image and text.
void uiTableAppendCheckboxTextColumn(uiTable *t, const char *name, int checkboxModelColumn, int checkboxEditableModelColumn, int textModelColumn, int textEditableModelColumn, uiTableTextColumnOptionalParams *textParams)
Appends a column to the table containing a checkbox and text.
int uiTableColumnWidth(uiTable *t, int column)
Returns the table column width.
void uiTableAppendTextColumn(uiTable *t, const char *name, int textModelColumn, int textEditableModelColumn, uiTableTextColumnOptionalParams *textParams)
Appends a text column to the table.
void uiTableSetSelectionMode(uiTable *t, uiTableSelectionMode mode)
Sets the table selection mode.
void uiTableSetSelection(uiTable *t, uiTableSelection *sel)
Sets the current table selection clearing any previous selection.
uiTable * uiNewTable(uiTableParams *params)
Creates a new table.
void uiTableOnSelectionChanged(uiTable *t, void(*f)(uiTable *t, void *data), void *data)
Registers a callback for when the table selection changed.
void uiTableHeaderOnClicked(uiTable *t, void(*f)(uiTable *sender, int column, void *senderData), void *data)
Registers a callback for when a table column header is clicked.
void uiTableAppendCheckboxColumn(uiTable *t, const char *name, int checkboxModelColumn, int checkboxEditableModelColumn)
Appends a column to the table containing a checkbox.
void uiTableHeaderSetSortIndicator(uiTable *t, int column, uiSortIndicator indicator)
Sets the column's sort indicator displayed in the table header.
uiTableSelectionMode uiTableGetSelectionMode(uiTable *t)
Returns the table selection mode.
void uiTableAppendImageColumn(uiTable *t, const char *name, int imageModelColumn)
Appends an image column to the table.
void uiTableHeaderSetVisible(uiTable *t, int visible)
Sets whether or not the table header is visible.
void uiTableAppendProgressBarColumn(uiTable *t, const char *name, int progressModelColumn)
Appends a column to the table containing a progress bar.
Developer defined methods for data retrieval and setting.
Definition: ui.h:3424
void(* SetCellValue)(uiTableModelHandler *, uiTableModel *, int, int, const uiTableValue *)
Sets the cell value for (row, column).
Definition: ui.h:3474
int(* NumColumns)(uiTableModelHandler *, uiTableModel *)
Returns the number of columns in the uiTableModel.
Definition: ui.h:3433
uiTableValueType(* ColumnType)(uiTableModelHandler *, uiTableModel *, int column)
Returns the column type in for of a uiTableValueType.
Definition: ui.h:3441
int(* NumRows)(uiTableModelHandler *, uiTableModel *)
Returns the number of rows in the uiTableModel.
Definition: ui.h:3446
Table model delegate to retrieve data and inform about model changes.
uiTableModel * uiNewTableModel(uiTableModelHandler *mh)
Creates a new table model.
void uiTableModelRowChanged(uiTableModel *m, int index)
Informs all associated uiTable views that a row has been changed.
void uiFreeTableModel(uiTableModel *m)
Frees the table model.
void uiTableModelRowInserted(uiTableModel *m, int newIndex)
Informs all associated uiTable views that a new row has been added.
void uiTableModelRowDeleted(uiTableModel *m, int oldIndex)
Informs all associated uiTable views that a row has been deleted.
Table parameters passed to uiNewTable().
Definition: ui.h:3566
int RowBackgroundColorModelColumn
uiTableModel column that defines background color for each row,
Definition: ui.h:3579
uiTableModel * Model
Model holding the data to be displayed.
Definition: ui.h:3570
Holds an array of selected row indices for a table.
Definition: ui.h:3973
void uiFreeTableSelection(uiTableSelection *s)
Frees the given uiTableSelection and all it's resources.
int * Rows
Array containing selected row indices, NULL on empty selection.
Definition: ui.h:3975
int NumRows
Number of selected rows.
Definition: ui.h:3974
Optional parameters to control the appearance of text columns.
Definition: ui.h:3547
int ColorModelColumn
uiTableModel column that defines the text color for each cell.
Definition: ui.h:3556
Container to store values used in container related methods.
int uiTableValueInt(const uiTableValue *v)
Returns the integer value held internally.
void uiTableValueColor(const uiTableValue *v, double *r, double *g, double *b, double *a)
Returns the color value held internally.
void uiFreeTableValue(uiTableValue *v)
Frees the uiTableValue.
uiTableValue * uiNewTableValueImage(uiImage *img)
Creates a new table value to store an image.
uiTableValueType uiTableValueGetType(const uiTableValue *v)
Gets the uiTableValue type.
uiTableValue * uiNewTableValueString(const char *str)
Creates a new table value to store a text string.
const char * uiTableValueString(const uiTableValue *v)
Returns the string value held internally.
uiTableValue * uiNewTableValueInt(int i)
Creates a new table value to store an integer.
uiTableValue * uiNewTableValueColor(double r, double g, double b, double a)
Creates a new table value to store a color in.
uiImage * uiTableValueImage(const uiTableValue *v)
Returns a reference to the image contained.
A control that represents a top-level window.
int uiWindowFocused(uiWindow *w)
Returns whether or not the window is focused.
void uiWindowPosition(uiWindow *w, int *x, int *y)
Gets the window position.
void uiWindowSetContentSize(uiWindow *w, int width, int height)
Sets the window content size.
void uiWindowSetResizeable(uiWindow *w, int resizeable)
Sets whether or not the window is user resizeable.
void uiWindowOnClosing(uiWindow *w, int(*f)(uiWindow *sender, void *senderData), void *data)
Registers a callback for when the window is to be closed.
int uiWindowBorderless(uiWindow *w)
Returns whether or not the window is borderless.
int uiWindowMargined(uiWindow *w)
Returns whether or not the window has a margin.
void uiWindowOnContentSizeChanged(uiWindow *w, void(*f)(uiWindow *sender, void *senderData), void *data)
Registers a callback for when the window content size is changed.
int uiWindowFullscreen(uiWindow *w)
Returns whether or not the window is full screen.
void uiWindowSetBorderless(uiWindow *w, int borderless)
Sets whether or not the window is borderless.
int uiWindowResizeable(uiWindow *w)
Returns whether or not the window is user resizeable.
char * uiWindowTitle(uiWindow *w)
Returns the window title.
void uiWindowSetTitle(uiWindow *w, const char *title)
Sets the window title.
void uiWindowSetChild(uiWindow *w, uiControl *child)
Sets the window's child.
void uiWindowSetFullscreen(uiWindow *w, int fullscreen)
Sets whether or not the window is full screen.
void uiWindowSetPosition(uiWindow *w, int x, int y)
Moves the window to the specified position.
void uiWindowOnPositionChanged(uiWindow *w, void(*f)(uiWindow *sender, void *senderData), void *data)
Registers a callback for when the window moved.
void uiWindowContentSize(uiWindow *w, int *width, int *height)
Gets the window content size.
void uiWindowOnFocusChanged(uiWindow *w, void(*f)(uiWindow *sender, void *senderData), void *data)
Registers a callback for when the window focus changes.
void uiWindowSetMargined(uiWindow *w, int margined)
Sets whether or not the window has a margin.
uiWindow * uiNewWindow(const char *title, int width, int height, int hasMenubar)
Creates a new uiWindow.
void uiDrawMatrixMultiply(uiDrawMatrix *dest, uiDrawMatrix *src)
uiAttribute * uiNewUnderlineAttribute(uiUnderline u)
void uiFreeAttributedString(uiAttributedString *s)
uiWindowResizeEdge
Definition: ui.h:2024
@ uiWindowResizeEdgeTop
Definition: ui.h:2026
@ uiWindowResizeEdgeBottom
Definition: ui.h:2028
@ uiWindowResizeEdgeBottomLeft
Definition: ui.h:2031
@ uiWindowResizeEdgeLeft
Definition: ui.h:2025
@ uiWindowResizeEdgeRight
Definition: ui.h:2027
@ uiWindowResizeEdgeTopLeft
Definition: ui.h:2029
@ uiWindowResizeEdgeBottomRight
Definition: ui.h:2032
@ uiWindowResizeEdgeTopRight
Definition: ui.h:2030
const uiOpenTypeFeatures * uiAttributeFeatures(const uiAttribute *a)
uiTableValueType
uiTableValue types.
Definition: ui.h:3251
@ uiTableValueTypeImage
Definition: ui.h:3253
@ uiTableValueTypeInt
Definition: ui.h:3254
@ uiTableValueTypeColor
Definition: ui.h:3255
@ uiTableValueTypeString
Definition: ui.h:3252
uiOpenTypeFeatures * uiNewOpenTypeFeatures(void)
#define _UI_ENUM(s)
Definition: ui.h:44
void uiDrawSave(uiDrawContext *c)
void uiDrawFreeTextLayout(uiDrawTextLayout *tl)
void uiOpenTypeFeaturesForEach(const uiOpenTypeFeatures *otf, uiOpenTypeFeaturesForEachFunc f, void *data)
uiAttributedString * uiNewAttributedString(const char *initialString)
uiAt
Placement specifier to define placement in relation to another control.
Definition: ui.h:3021
@ uiAtTop
Place above control.
Definition: ui.h:3023
@ uiAtLeading
Place before control.
Definition: ui.h:3022
@ uiAtBottom
Place below control.
Definition: ui.h:3025
@ uiAtTrailing
Place behind control.
Definition: ui.h:3024
void uiDrawPathNewFigureWithArc(uiDrawPath *p, double xCenter, double yCenter, double radius, double startAngle, double sweep, int negative)
struct uiAttributedString uiAttributedString
Definition: ui.h:2546
uiAttribute * uiNewSizeAttribute(double size)
void uiLoadControlFont(uiFontDescriptor *f)
const char * uiInit(uiInitOptions *options)
void uiDrawPathAddRectangle(uiDrawPath *p, double x, double y, double width, double height)
size_t uiAttributedStringByteIndexToGrapheme(uiAttributedString *s, size_t pos)
size_t uiAttributedStringGraphemeToByteIndex(uiAttributedString *s, size_t pos)
uiForEach(* uiAttributedStringForEachAttributeFunc)(const uiAttributedString *s, const uiAttribute *a, size_t start, size_t end, void *data)
Definition: ui.h:2552
void uiMainSteps(void)
void uiAttributedStringDelete(uiAttributedString *s, size_t start, size_t end)
void uiDrawFill(uiDrawContext *c, uiDrawPath *path, uiDrawBrush *b)
uiArea * uiNewScrollingArea(uiAreaHandler *ah, int width, int height)
void uiAttributeColor(const uiAttribute *a, double *r, double *g, double *b, double *alpha)
uiTextItalic
Definition: ui.h:2315
@ uiTextItalicOblique
Definition: ui.h:2317
@ uiTextItalicItalic
Definition: ui.h:2318
@ uiTextItalicNormal
Definition: ui.h:2316
void uiDrawPathLineTo(uiDrawPath *p, double x, double y)
void uiDrawFreePath(uiDrawPath *p)
uiModifiers
Keyboard modifier keys.
Definition: ui.h:2775
@ uiModifierAlt
Alternate/Option key.
Definition: ui.h:2777
@ uiModifierSuper
Super/Command/Windows key.
Definition: ui.h:2779
@ uiModifierShift
Shift key.
Definition: ui.h:2778
@ uiModifierCtrl
Control key.
Definition: ui.h:2776
void uiFreeText(char *text)
Free the memory of a returned string.
void uiAttributeUnderlineColor(const uiAttribute *a, uiUnderlineColor *u, double *r, double *g, double *b, double *alpha)
uiOpenTypeFeatures * uiOpenTypeFeaturesClone(const uiOpenTypeFeatures *otf)
void uiTimer(int milliseconds, int(*f)(void *data), void *data)
void uiMain(void)
uiDrawTextAlign
Definition: ui.h:2650
@ uiDrawTextAlignCenter
Definition: ui.h:2652
@ uiDrawTextAlignLeft
Definition: ui.h:2651
@ uiDrawTextAlignRight
Definition: ui.h:2653
void uiFreeInitError(const char *err)
uiForEach(* uiOpenTypeFeaturesForEachFunc)(const uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t value, void *data)
Definition: ui.h:2453
struct uiAttribute uiAttribute
Definition: ui.h:2221
int uiOpenTypeFeaturesGet(const uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t *value)
struct uiDrawPath uiDrawPath
Definition: ui.h:2068
uiDrawTextLayout * uiDrawNewTextLayout(uiDrawTextLayoutParams *params)
uiAttributeType uiAttributeGetType(const uiAttribute *a)
uiTextWeight
Definition: ui.h:2284
@ uiTextWeightMaximum
Definition: ui.h:2297
@ uiTextWeightNormal
Definition: ui.h:2290
@ uiTextWeightBook
Definition: ui.h:2289
@ uiTextWeightMedium
Definition: ui.h:2291
@ uiTextWeightUltraLight
Definition: ui.h:2287
@ uiTextWeightBold
Definition: ui.h:2293
@ uiTextWeightUltraBold
Definition: ui.h:2294
@ uiTextWeightSemiBold
Definition: ui.h:2292
@ uiTextWeightUltraHeavy
Definition: ui.h:2296
@ uiTextWeightLight
Definition: ui.h:2288
@ uiTextWeightThin
Definition: ui.h:2286
@ uiTextWeightMinimum
Definition: ui.h:2285
@ uiTextWeightHeavy
Definition: ui.h:2295
struct uiDrawContext uiDrawContext
Definition: ui.h:2009
int uiDrawMatrixInvertible(uiDrawMatrix *m)
void uiQuit(void)
void uiAreaQueueRedrawAll(uiArea *a)
uiAttribute * uiNewFamilyAttribute(const char *family)
void uiUninit(void)
uiTextStretch uiAttributeStretch(const uiAttribute *a)
void uiAttributedStringAppendUnattributed(uiAttributedString *s, const char *str)
uiAttribute * uiNewColorAttribute(double r, double g, double b, double a)
void uiDrawMatrixTranslate(uiDrawMatrix *m, double x, double y)
const char * uiAttributedStringString(const uiAttributedString *s)
void uiDrawPathEnd(uiDrawPath *p)
void uiDrawText(uiDrawContext *c, uiDrawTextLayout *tl, double x, double y)
void uiOpenTypeFeaturesRemove(uiOpenTypeFeatures *otf, char a, char b, char c, char d)
void uiAttributedStringInsertAtUnattributed(uiAttributedString *s, const char *str, size_t at)
uiAttribute * uiNewFeaturesAttribute(const uiOpenTypeFeatures *otf)
void uiDrawClip(uiDrawContext *c, uiDrawPath *path)
uiUnderline uiAttributeUnderline(const uiAttribute *a)
void uiQueueMain(void(*f)(void *data), void *data)
uiTextWeight uiAttributeWeight(const uiAttribute *a)
double uiAttributeSize(const uiAttribute *a)
void uiDrawTransform(uiDrawContext *c, uiDrawMatrix *m)
uiAttribute * uiNewWeightAttribute(uiTextWeight weight)
uiAttribute * uiNewBackgroundAttribute(double r, double g, double b, double a)
uiAttributeType
Definition: ui.h:2234
@ uiAttributeTypeUnderline
Definition: ui.h:2242
@ uiAttributeTypeBackground
Definition: ui.h:2241
@ uiAttributeTypeFamily
Definition: ui.h:2235
@ uiAttributeTypeItalic
Definition: ui.h:2238
@ uiAttributeTypeColor
Definition: ui.h:2240
@ uiAttributeTypeUnderlineColor
Definition: ui.h:2243
@ uiAttributeTypeStretch
Definition: ui.h:2239
@ uiAttributeTypeSize
Definition: ui.h:2236
@ uiAttributeTypeFeatures
Definition: ui.h:2244
@ uiAttributeTypeWeight
Definition: ui.h:2237
void uiAreaBeginUserWindowMove(uiArea *a)
uiUnderline
Definition: ui.h:2379
@ uiUnderlineSuggestion
Definition: ui.h:2383
@ uiUnderlineSingle
Definition: ui.h:2381
@ uiUnderlineDouble
Definition: ui.h:2382
@ uiUnderlineNone
Definition: ui.h:2380
uiExtKey
Definition: ui.h:2802
@ uiExtKeyF8
Definition: ui.h:2821
@ uiExtKeyNSubtract
Definition: ui.h:2839
@ uiExtKeyF5
Definition: ui.h:2818
@ uiExtKeyF3
Definition: ui.h:2816
@ uiExtKeyN3
Definition: ui.h:2829
@ uiExtKeyPageUp
Definition: ui.h:2808
@ uiExtKeyF12
Definition: ui.h:2825
@ uiExtKeyF4
Definition: ui.h:2817
@ uiExtKeyRight
Definition: ui.h:2813
@ uiExtKeyNDot
Definition: ui.h:2836
@ uiExtKeyDelete
Definition: ui.h:2805
@ uiExtKeyNAdd
Definition: ui.h:2838
@ uiExtKeyN6
Definition: ui.h:2832
@ uiExtKeyNEnter
Definition: ui.h:2837
@ uiExtKeyDown
Definition: ui.h:2811
@ uiExtKeyF10
Definition: ui.h:2823
@ uiExtKeyN8
Definition: ui.h:2834
@ uiExtKeyN4
Definition: ui.h:2830
@ uiExtKeyInsert
Definition: ui.h:2804
@ uiExtKeyN0
Definition: ui.h:2826
@ uiExtKeyN5
Definition: ui.h:2831
@ uiExtKeyN1
Definition: ui.h:2827
@ uiExtKeyF11
Definition: ui.h:2824
@ uiExtKeyF1
Definition: ui.h:2814
@ uiExtKeyF2
Definition: ui.h:2815
@ uiExtKeyF6
Definition: ui.h:2819
@ uiExtKeyLeft
Definition: ui.h:2812
@ uiExtKeyUp
Definition: ui.h:2810
@ uiExtKeyEscape
Definition: ui.h:2803
@ uiExtKeyF7
Definition: ui.h:2820
@ uiExtKeyN7
Definition: ui.h:2833
@ uiExtKeyNDivide
Definition: ui.h:2841
@ uiExtKeyEnd
Definition: ui.h:2807
@ uiExtKeyN2
Definition: ui.h:2828
@ uiExtKeyHome
Definition: ui.h:2806
@ uiExtKeyF9
Definition: ui.h:2822
@ uiExtKeyPageDown
Definition: ui.h:2809
@ uiExtKeyN9
Definition: ui.h:2835
@ uiExtKeyNMultiply
Definition: ui.h:2840
#define _UI_EXTERN
Definition: ui.h:39
uiForEach
Definition: ui.h:53
@ uiForEachStop
Definition: ui.h:55
@ uiForEachContinue
Definition: ui.h:54
void uiAreaBeginUserWindowResize(uiArea *a, uiWindowResizeEdge edge)
void uiDrawTextLayoutExtents(uiDrawTextLayout *tl, double *width, double *height)
size_t uiAttributedStringLen(const uiAttributedString *s)
uiDrawPath * uiDrawNewPath(uiDrawFillMode fillMode)
uiAttribute * uiNewUnderlineColorAttribute(uiUnderlineColor u, double r, double g, double b, double a)
int uiDrawPathEnded(uiDrawPath *p)
void uiDrawPathNewFigure(uiDrawPath *p, double x, double y)
void uiDrawStroke(uiDrawContext *c, uiDrawPath *path, uiDrawBrush *b, uiDrawStrokeParams *p)
size_t uiAttributedStringNumGraphemes(uiAttributedString *s)
uiDrawLineJoin
Definition: ui.h:2088
@ uiDrawLineJoinRound
Definition: ui.h:2090
@ uiDrawLineJoinMiter
Definition: ui.h:2089
@ uiDrawLineJoinBevel
Definition: ui.h:2091
void uiFreeFontDescriptor(uiFontDescriptor *desc)
const char * uiAttributeFamily(const uiAttribute *a)
void uiDrawPathArcTo(uiDrawPath *p, double xCenter, double yCenter, double radius, double startAngle, double sweep, int negative)
uiDrawFillMode
Definition: ui.h:2099
@ uiDrawFillModeWinding
Definition: ui.h:2100
@ uiDrawFillModeAlternate
Definition: ui.h:2101
uiDrawLineCap
Definition: ui.h:2082
@ uiDrawLineCapRound
Definition: ui.h:2084
@ uiDrawLineCapFlat
Definition: ui.h:2083
@ uiDrawLineCapSquare
Definition: ui.h:2085
void uiOpenTypeFeaturesAdd(uiOpenTypeFeatures *otf, char a, char b, char c, char d, uint32_t value)
void uiDrawMatrixTransformSize(uiDrawMatrix *m, double *x, double *y)
void uiFreeOpenTypeFeatures(uiOpenTypeFeatures *otf)
uiTextItalic uiAttributeItalic(const uiAttribute *a)
void uiDrawMatrixSetIdentity(uiDrawMatrix *m)
void uiAreaSetSize(uiArea *a, int width, int height)
void uiDrawPathCloseFigure(uiDrawPath *p)
struct uiOpenTypeFeatures uiOpenTypeFeatures
Definition: ui.h:2447
void uiAttributedStringSetAttribute(uiAttributedString *s, uiAttribute *a, size_t start, size_t end)
struct uiArea uiArea
Definition: ui.h:2003
void uiDrawMatrixRotate(uiDrawMatrix *m, double x, double y, double amount)
uiAttribute * uiNewItalicAttribute(uiTextItalic italic)
int uiDrawMatrixInvert(uiDrawMatrix *m)
void uiUserBugCannotSetParentOnToplevel(const char *type)
struct uiDrawTextLayout uiDrawTextLayout
Definition: ui.h:2645
uiUnderlineColor
Definition: ui.h:2407
@ uiUnderlineColorCustom
Definition: ui.h:2408
@ uiUnderlineColorAuxiliary
Definition: ui.h:2411
@ uiUnderlineColorGrammar
Definition: ui.h:2410
@ uiUnderlineColorSpelling
Definition: ui.h:2409
void uiAreaScrollTo(uiArea *a, double x, double y, double width, double height)
void uiDrawMatrixScale(uiDrawMatrix *m, double xCenter, double yCenter, double x, double y)
uiAlign
Alignment specifiers to define placement within the reserved area.
Definition: ui.h:3008
@ uiAlignStart
Place at start.
Definition: ui.h:3010
@ uiAlignEnd
Place at end.
Definition: ui.h:3012
@ uiAlignFill
Fill area.
Definition: ui.h:3009
@ uiAlignCenter
Place in center.
Definition: ui.h:3011
uiDrawBrushType
Definition: ui.h:2075
@ uiDrawBrushTypeImage
Definition: ui.h:2079
@ uiDrawBrushTypeSolid
Definition: ui.h:2076
@ uiDrawBrushTypeLinearGradient
Definition: ui.h:2077
@ uiDrawBrushTypeRadialGradient
Definition: ui.h:2078
void uiOnShouldQuit(int(*f)(void *data), void *data)
uiArea * uiNewArea(uiAreaHandler *ah)
void uiDrawRestore(uiDrawContext *c)
void uiDrawMatrixTransformPoint(uiDrawMatrix *m, double *x, double *y)
void uiAttributedStringForEachAttribute(const uiAttributedString *s, uiAttributedStringForEachAttributeFunc f, void *data)
void uiDrawPathBezierTo(uiDrawPath *p, double c1x, double c1y, double c2x, double c2y, double endX, double endY)
uiTextStretch
Definition: ui.h:2341
@ uiTextStretchSemiCondensed
Definition: ui.h:2345
@ uiTextStretchExpanded
Definition: ui.h:2348
@ uiTextStretchExtraExpanded
Definition: ui.h:2349
@ uiTextStretchUltraExpanded
Definition: ui.h:2350
@ uiTextStretchExtraCondensed
Definition: ui.h:2343
@ uiTextStretchCondensed
Definition: ui.h:2344
@ uiTextStretchSemiExpanded
Definition: ui.h:2347
@ uiTextStretchNormal
Definition: ui.h:2346
@ uiTextStretchUltraCondensed
Definition: ui.h:2342
void uiDrawMatrixSkew(uiDrawMatrix *m, double x, double y, double xamount, double yamount)
void uiFreeAttribute(uiAttribute *a)
uiAttribute * uiNewStretchAttribute(uiTextStretch stretch)
int uiMainStep(int wait)
@ uiTableSelectionModeZeroOrMany
Allow zero or many (multiple) rows to be selected.
Definition: ui.h:3924
@ uiTableSelectionModeZeroOrOne
Allow zero or one row to be selected.
Definition: ui.h:3922
@ uiTableSelectionModeNone
Allow no row selection.
Definition: ui.h:3921
@ uiTableSelectionModeOne
Allow for exactly one row to be selected.
Definition: ui.h:3923
@ uiSortIndicatorNone
Definition: ui.h:3382
@ uiSortIndicatorDescending
Definition: ui.h:3384
@ uiSortIndicatorAscending
Definition: ui.h:3383