Author: [email protected]
Date: Fri Jun 5 07:43:03 2009
New Revision: 5514
Added:
wiki/ImageResource.wiki
Log:
Created wiki page through web user interface.
Added: wiki/ImageResource.wiki
==============================================================================
--- (empty file)
+++ wiki/ImageResource.wiki Fri Jun 5 07:43:03 2009
@@ -0,0 +1,36 @@
+#summary Compile-time image processing
+
+<wiki:toc />
+
+= Goal =
+ * Provide access to image data at runtime in the most efficient way
possible
+
+= Non-goals =
+ * To provide a general-purpose image manipulation framework.
+
+= Overview =
+
+ 1 Define a ClientBundle with one or more ImageResource accessors:
+ {{{
+interface Resources extends ClientBundle {
+ @Source("logo.png")
+ ImageResource logo();
+
+ @Source("arrow.png")
+ @ImageOptions(flipRtl = true)
+ ImageResource pointer();
+}
+}}}
+ 1 Instantiate the ClientBundle via a call to `GWT.create()`.
+ 1 Instantiate one or more Image widget or use with the
[CssResource#Image_Sprites CssResource @sprite] directive.
+
+== `ImageOptions` ==
+The `...@imageoptions` annotation can be applied to the ImageResource
accessor method in order to tune the compile-time processing of the image
data
+ * `flipRtl` is a boolean value that will cause the image to be mirrored
about its Y-axis when `LocaleInfo.isRTL()` returns `true`.
+ * `repeatStyle` is an enumerated value that is used in combination with
t...@sprite` directive to indicate that the image is intended to be tiled.
+
+== Supported formats ==
+`ImageBundleBuilder` uses the Java
[http://java.sun.com/javase/6/docs/api/javax/imageio/package-summary.html
ImageIO] framework to read image data. This includes support for all common
web image formats.
+
+== Future development ==
+ * Add compile-time scaling to images. This would allow a single
high-resolution image to be scaled at compile time to the desired size.
\ No newline at end of file
--~--~---------~--~----~------------~-------~--~----~
http://groups.google.com/group/Google-Web-Toolkit-Contributors
-~----------~----~----~----~------~----~------~--~---
