dorkbox.util.jna.linux.Gtk3 Maven / Gradle / Ivy
/*
* Copyright 2017 dorkbox, llc
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package dorkbox.util.jna.linux;
import com.sun.jna.Function;
import com.sun.jna.NativeLibrary;
import com.sun.jna.Pointer;
import dorkbox.util.jna.linux.structs.GtkStyle;
/**
* bindings for GTK+ 3.
*
* Direct-mapping, See: https://github.com/java-native-access/jna/blob/master/www/DirectMapping.md
*/
@SuppressWarnings("WeakerAccess")
public
class Gtk3 implements Gtk {
private static Function gdk_window_get_scale_factor = null;
private static Function gtk_show_uri_on_window = null;
// objdump -T /usr/lib/x86_64-linux-gnu/libgtk-3.so.0 | grep gtk
// objdump -T /usr/local/lib/libgtk-3.so.0 | grep gtk
/**
* Loads version specific methods
*/
static
void loadMethods(final NativeLibrary library) {
// Abusing static fields this way is not proper, but it gets the job done nicely.
if (GtkCheck.gtkIsGreaterOrEqual(3, 10, 0)) {
gdk_window_get_scale_factor = library.getFunction("gdk_window_get_scale_factor");
}
if (GtkCheck.gtkIsGreaterOrEqual(3, 22, 0)) {
gtk_show_uri_on_window = library.getFunction("gtk_show_uri_on_window");
}
}
/**
* Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management.
*
* This is used to retrieve a suitable size by container widgets which do not impose any restrictions on the child placement.
* It can be used to deduce toplevel window and menu sizes as well as child widgets in free-form containers such as GtkLayout.
*
* Handle with care. Note that the natural height of a height-for-width widget will generally be a smaller size than the minimum
* height, since the required height for the natural width is generally smaller than the required height for the minimum width.
*
* Use gtk_widget_get_preferred_height_and_baseline_for_width() if you want to support baseline alignment.
*
* @param widget a GtkWidget instance
* @param minimum_size location for storing the minimum size, or NULL.
* @param natural_size location for storing the natural size, or NULL.
*/
public native
void gtk_widget_get_preferred_size(final Pointer widget, final Pointer minimum_size, final Pointer natural_size);
/**
* Returns the internal scale factor that maps from window coordinates to the actual device pixels. On traditional systems this is 1,
* but on very high density outputs this can be a higher value (often 2).
*
* A higher value means that drawing is automatically scaled up to a higher resolution, so any code doing drawing will automatically
* look nicer. However, if you are supplying pixel-based data the scale value can be used to determine whether to use a pixel
* resource with higher resolution data.
*
* The scale of a window may change during runtime, if this happens a configure event will be sent to the toplevel window.
*
* @return the scale factor
*
* @since 3.10
*/
public
int gdk_window_get_scale_factor(Pointer window) {
if (gdk_window_get_scale_factor != null) {
return gdk_window_get_scale_factor.invokeInt(new Object[]{window});
} else {
return 0;
}
}
/**
* @return TRUE on success, FALSE on error
*
* @since: 3.22
*/
public
boolean gtk_show_uri_on_window(final Pointer parent, final String uri, final int timestamp, final Pointer error) {
if (gtk_show_uri_on_window != null) {
return (Boolean) gtk_show_uri_on_window.invoke(Boolean.class, new Object[] {parent, uri, timestamp, error});
}
else {
return false;
}
}
///////////////////////////
//// GTK2 methods
///////////////////////////
/**
* This function is typically used when implementing a GtkContainer subclass. Obtains the preferred size of a widget. The
* container uses this information to arrange its child widgets and decide what size allocations to give them with
* gtk_widget_size_allocate().
*
* You can also call this function from an application, with some caveats. Most notably, getting a size request requires the
* widget to be associated with a screen, because font information may be needed. Multihead-aware applications should keep this in mind.
*
* Also remember that the size request is not necessarily the size a widget will actually be allocated.
*/
@Override
public
void gtk_widget_size_request(final Pointer widget, final Pointer requisition) {
this.gtk_widget_get_preferred_size(widget, requisition, null);
}
@Override
public native
boolean gtk_init_check(final int argc);
@Override
public native
GMainLoop g_main_loop_new(Pointer context, boolean is_running);
@Override
public native
GMainContext g_main_loop_get_context(GMainLoop loop);
@Override
public native
void g_main_loop_run(GMainLoop loop);
@Override
public native
void g_main_context_invoke(GMainContext c, FuncCallback func, Pointer data);
@Override
public native
void g_main_loop_quit(GMainLoop loop);
@Override
public native
Pointer gtk_menu_new();
@Override
public native
void gtk_menu_item_set_submenu(final Pointer menuEntry, final Pointer menu);
@Override
public native
Pointer gtk_separator_menu_item_new();
@Override
public native
Pointer gtk_image_new_from_file(final String iconPath);
@Override
public native
void gtk_check_menu_item_set_active(final Pointer check_menu_item, final boolean isChecked);
@Override
public native
Pointer gtk_image_menu_item_new_with_mnemonic(final String label);
@Override
public native
Pointer gtk_check_menu_item_new_with_mnemonic(final String label);
@Override
public native
void gtk_image_menu_item_set_image(final Pointer image_menu_item, final Pointer image);
@Override
public native
void gtk_image_menu_item_set_always_show_image(final Pointer menu_item, final boolean forceShow);
@Override
public native
Pointer gtk_status_icon_new();
@Override
public native
Pointer gdk_get_default_root_window();
@Override
public native
Pointer gdk_screen_get_default();
@Override
public native
double gdk_screen_get_resolution(final Pointer screen);
@Override
public native
void gtk_status_icon_set_from_file(final Pointer widget, final String label);
@Override
public native
void gtk_status_icon_set_visible(final Pointer widget, final boolean visible);
@Override
public native
void gtk_status_icon_set_tooltip_text(final Pointer widget, final String tooltipText);
@Override
public native
void gtk_status_icon_set_title(final Pointer widget, final String titleText);
@Override
public native
void gtk_status_icon_set_name(final Pointer widget, final String name);
@Override
public native
void gtk_menu_popup(final Pointer menu,
final Pointer widget,
final Pointer bla,
final Function func,
final Pointer data,
final int button,
final int time);
@Override
public native
void gtk_menu_item_set_label(final Pointer menu_item, final String label);
@Override
public native
void gtk_menu_shell_append(final Pointer menu_shell, final Pointer child);
@Override
public native
void gtk_widget_set_sensitive(final Pointer widget, final boolean sensitive);
@Override
public native
void gtk_widget_show_all(final Pointer widget);
@Override
public native
void gtk_container_remove(final Pointer parentWidget, final Pointer widget);
@Override
public native
void gtk_widget_destroy(final Pointer widget);
@Override
public native
Pointer gtk_settings_get_for_screen(final Pointer screen);
@Override
public native
GtkStyle gtk_rc_get_style(final Pointer widget);
@Override
public native
void gtk_container_add(final Pointer offscreen, final Pointer widget);
@Override
public native
Pointer gtk_bin_get_child(final Pointer bin);
@Override
public native
Pointer gtk_label_get_layout(final Pointer label);
@Override
public native
void pango_layout_get_pixel_extents(final Pointer layout, final Pointer ink_rect, final Pointer logical_rect);
@Override
public native
void gtk_widget_realize(final Pointer widget);
@Override
public native
Pointer gtk_offscreen_window_new();
@Override
public native
Pointer gtk_image_menu_item_new_from_stock(final String stock_id, final Pointer accel_group);
@Override
public native
boolean gtk_show_uri(final Pointer screen, final String uri, final int timestamp, final Pointer error);
@Override
public native
void gtk_widget_set_tooltip_text(final Pointer widget, final String text);
@Override
public native
Pointer gdk_display_get_default();
}