Difference between revisions of "GridImageUpload"

Latest revision as of 07:55, 6 December 2009

Download

Windows: 1.0.4

OSX: Not available yet

Source

GridImageUpload:

Latest version under SLImageUpload name: http://openmv.org/svn/libsl/libopenmetaverse/tags/0.5.0/SLImageUpload/

Requirements

On Windows you will need the .NET 2.0 framework installed. On OSX you will need a recent copy of Mono and X11 installed (instructions for installing X11 on Tiger here). On Windows, simply run the installer. On OSX, open the DMG and drag GridImageUpload to Applications (or anywhere you wish to install it) and double-click the GridImageUpload application. It will only run if X11 and Mono (preferably Mono-2.4 or newer, but older versions should work) have been installed.

Usage

Load an image to see what the final (JPEG2000 compressed) file size will be before uploading. You can experiment by checking and unchecking lossless encoding. Often times small images will compress to a smaller size with lossless encoding as it only uses a single quality level instead of the multiple quality levels created with lossy encoding. Once the image is uploaded you have three ways of retrieving it: using the resulting texture UUID in a script, logging in to SL with the same account you uploaded with and finding the filename of the uploaded image in your inventory, or using the send copy to avatar function to send a copy of the image to another account.

LSL Instructions

For a regular texture: <lsl>llSetTexture( "UUID_KEY_GOES_HERE", ALL_SIDES );</lsl>

For a sculpt map texture: <lsl>llSetPrimitiveParams( [ PRIM_TYPE, PRIM_TYPE_SCULPT, "UUID_KEY_GOES_HERE", PRIM_SCULPT_TYPE_SPHERE ] ); </lsl>

Release Notes

1.0.4

Renamed to GridImageUpload to avoid potential copyright issues and to signify the support for open source virtual worlds such as OpenSim
Added a login URL box to allow logging in to the beta grid or alternative grids such as OpenSim
Added a Save Image button to save JPEG2000 compressed textures to the hard drive without having to login to a grid
Regression: The upload progress bar no longer works. This is due to a technical issue in the way libOpenMetaverse works; the tradeoff is better reliability, performance, and faster shutdown times

1.0.3

Uploads are working yet again. Switched from WebClient class to a homebrewed version that is working on Mono and .NET alike
Progress bar should be working in this release
First release of the OSX version
New OpenJPEG release with speed and image quality improvements

1.0.2

Uploads are working again. Using the new CAPS system which should (and seems to) give faster, more reliable uploads
Progress bar is broken in this release
Uploaded images are added to inventory, permissions are set to full
A copy is sent to another avatar if requested
Fixed bug with lossless not being turned on or off when the checkbox was clicked sometimes

@@ Line 1: / Line 1: @@
-[[Image:Slimageupload-02.png]]
+[[Image:Slimageupload-03.png|right]]
 ==Download==
-[http://www.jhurliman.org/download/SLImageUpload-1.0.1.zip 1.0.1]
+Windows: [http://www.jhurliman.org/download/GridImageUploadInstaller-1.0.4.exe 1.0.4]
+OSX: Not available yet
+== Source ==
+GridImageUpload:
+* http://openmv.org/svn/libsl/libopenmetaverse/branches/simd/Programs/GridImageUpload/
+* http://openmv.org/svn/libsl/libopenmetaverse/branches/modularized/Programs/GridImageUpload/
+Latest version under SLImageUpload name: http://openmv.org/svn/libsl/libopenmetaverse/tags/0.5.0/SLImageUpload/
 ==Requirements==
-Windows and .NET 2.0 for this version, when I get the image compression library compiled for other platforms it will work on Linux and OSX.
+{{justify|text=On Windows you will need the .NET 2.0 framework installed. On OSX you will need a recent copy of [http://www.mono-project.com/ Mono] and X11 installed (instructions for installing X11 on Tiger [http://overstimulate.com/articles/installing-x11-on-os-x-10-4-tiger here]). On Windows, simply run the installer. On OSX, open the DMG and drag GridImageUpload to Applications (or anywhere you wish to install it) and double-click the GridImageUpload application. It will only run if X11 and Mono (preferably Mono-2.4 or newer, but older versions should work) have been installed.}}
+==Usage==
+{{justify|Load an image to see what the final (JPEG2000 compressed) file size will be before uploading. You can experiment by checking and unchecking lossless encoding. Often times small images will compress to a smaller size with lossless encoding as it only uses a single quality level instead of the multiple quality levels created with lossy encoding. Once the image is uploaded you have three ways of retrieving it: using the resulting texture UUID in a script, logging in to SL with the same account you uploaded with and finding the filename of the uploaded image in your inventory, or using the send copy to avatar function to send a copy of the image to another account.}}
+===LSL Instructions===
+'''For a regular texture:'''
+<lsl>llSetTexture( "UUID_KEY_GOES_HERE", ALL_SIDES );</lsl>
+'''For a sculpt map texture:'''
+<lsl>llSetPrimitiveParams( [ PRIM_TYPE, PRIM_TYPE_SCULPT, "UUID_KEY_GOES_HERE", PRIM_SCULPT_TYPE_SPHERE ] ); </lsl>
-==Note==
+==Release Notes==
-This program may alter images, but it is disputed.  It is known that various parts of the image delivery path (the way the image is delivered *back* to your client) can often alter the image before you see it, so even if SLImageUpload does a good job with lossless uploading, SL and the SL client are known to damage the image on the way back to you.  Sometimes.  Qarl Linden is very tuned in to this entire issue, and promises a fix that is currently being tested.  Regardless of source, the effect can be seen fairly easily when uploading low resolution (e.g. 32x32) images losslessly with solid gray boarders around colored blocks.  When you see it used in your client, it will look very blurry, despite being uploaded losslessly.  Interestingly, the cache system of the SL client also damages images, and clearing your cache can (temporarily) improve the image quality.  The effects are varied, and not all images are affected noticibly.
+=====1.0.4=====
-The Maya lossless uploader by the same author does appear to upload losslessly without corruption (we tested it).
+* Renamed to GridImageUpload to avoid potential copyright issues and to signify the support for open source virtual worlds such as OpenSim
+* Added a login URL box to allow logging in to the beta grid or alternative grids such as OpenSim
+* Added a Save Image button to save JPEG2000 compressed textures to the hard drive without having to login to a grid
+* Regression: The upload progress bar no longer works. This is due to a technical issue in the way libOpenMetaverse works; the tradeoff is better reliability, performance, and faster shutdown times
-It can be downloaded from:
+=====1.0.3=====
-http://www.jhurliman.org/download/importprimscript-1.0.2.zip
-With some work it may be usable as an alternative to this program.  The uploading executable itself does not require Maya.
+* Uploads are working yet again. Switched from WebClient class to a homebrewed version that is working on Mono and .NET alike
+* Progress bar should be working in this release
+* First release of the OSX version
+* New OpenJPEG release with speed and image quality improvements
+=====1.0.2=====
-For more information, see:
+* Uploads are working again. Using the new CAPS system which should (and seems to) give faster, more reliable uploads
-https://jira.secondlife.com/browse/VWR-866
+* Progress bar is broken in this release
-and
+* Uploaded images are added to inventory, permissions are set to full
-http://jira.secondlife.com/browse/VWR-2404
+* A copy is sent to another avatar if requested
+* Fixed bug with lossless not being turned on or off when the checkbox was clicked sometimes